# LineItems: HubSpot Line Items List Read a page of line items. Control what is returned via the `properties` query param. - Catalog: `LineItems` - Schema: `Basic` - Label: Line Items - Retrieve: True - Insert: True - Update: False - Delete: False ## Parameters of Table Function The following parameters can be used to control the behaviour of the table function `LineItems`. A value must be provided at all times for required parameters, but optional parameters in general do not need to have a value and the execution will default to a pre-defined behaviour. Values can be specified by position and by name. In both cases, all parameters not specified will be evaluated using their default values. Value specification by position is done by listing all values from the first to the last needed value. For example: a `select * from table(value1, value2, value3)` on a table with four parameters will use the default value for the fourth parameter and the specified values for the first three. Value specification by name is done by listing all values that require a value. For example with `select * from table(name1 => value1, name3 => value3)` on the same table will use the default values for the second and fourth parameters and the specified values for the first and third. | Name | Data Type | Required | Default Value | Documentation | |---|:---:|:---:|:---:|---| | `after` | `` | ☐ | | The paging cursor token of the last successfully read resource will be returned as the `paging.next.after` JSON property of a paged response containing more results. | | `archived` | `` | ☐ | | Whether to return only results that have been archived. | ## Columns of Table Function The columns of the table function `LineItems` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert. | Name | Data Type | Label | Required | Documentation | |---|:---:|---|:---:|---| | `archived` | `char` | Archived | ☐ | Whether the object is archived. | | `archivedAt` | `datetime` | Archived at | ☐ | The timestamp when the object was archived, in ISO 8601 format. | | `associations` | `varchar2` | Associations | ☐ | A list defining relationships with other objects. | | `createdAt` | `datetime` | Created at | ☐ | The timestamp when the object was created, in ISO 8601 format. | | `id` | `varchar2` | ID | ☐ | The unique ID of the object. | | `objectWriteTraceId` | `varchar2` | | ☐ | An identifier used for tracing the creation or update request of the object. | | `prop_amount` | `decimal` | Amount | ☐ | | | `prop_createdate` | `datetime` | Created at | ☐ | | | `prop_description` | `varchar2` | Description | ☐ | | | `prop_discount` | `decimal` | Discount | ☐ | | | `prop_hs_acv` | `decimal` | Annual Contract Value | ☐ | | | `prop_hs_all_accessible_team_ids` | `varchar2` | All Accessible Team IDs | ☐ | | | `prop_hs_all_assigned_business_unit_ids` | `varchar2` | All Assigned Business Unit IDs | ☐ | | | `prop_hs_all_owner_ids` | `varchar2` | All Owner IDs | ☐ | | | `prop_hs_all_team_ids` | `varchar2` | All Team IDs | ☐ | | | `prop_hs_allow_buyer_selected_quantity` | `varchar2` | Allow Buyer Selected Quantity | ☐ | | | `prop_hs_arr` | `decimal` | Annual Recurring Revenues | ☐ | | | `prop_hs_billing_period_end_date` | `datetime` | | ☐ | | | `prop_hs_billing_period_start_date` | `datetime` | | ☐ | | | `prop_hs_billing_start_delay_days` | `decimal` | Billing Start Delay Days | ☐ | | | `prop_hs_billing_start_delay_months` | `decimal` | Billing Start Delay Months | ☐ | | | `prop_hs_billing_start_delay_type` | `varchar2` | Billing Start Delay Type | ☐ | | | `prop_hs_buyer_selected_quantity_max` | `decimal` | | ☐ | | | `prop_hs_buyer_selected_quantity_min` | `decimal` | | ☐ | | | `prop_hs_cost_of_goods_sold` | `decimal` | Cost of Goods Sold | ☐ | | | `prop_hs_created_by_user_id` | `decimal` | Created by User ID | ☐ | | | `prop_hs_createdate` | `datetime` | Created at | ☐ | | | `prop_hs_discount_percentage` | `decimal` | Discount Percentage | ☐ | | | `prop_hs_effective_unit_price` | `decimal` | | ☐ | | | `prop_hs_external_id` | `decimal` | External ID | ☐ | | | `prop_hs_external_tax_rate_id` | `varchar2` | | ☐ | | | `prop_hs_images` | `varchar2` | Images | ☐ | | | `prop_hs_is_editable_price` | `char` | | ☐ | | | `prop_hs_is_optional` | `char` | | ☐ | | | `prop_hs_lastmodifieddate` | `datetime` | Last Modified Date | ☐ | | | `prop_hs_line_item_currency_code` | `varchar2` | Line Item Currency Code | ☐ | | | `prop_hs_margin_acv` | `decimal` | Margin Annual Contract Value | ☐ | | | `prop_hs_margin_arr` | `decimal` | Margin Annual Recurring Revenues | ☐ | | | `prop_hs_margin_mrr` | `decimal` | Margin Monthly Recurring Revenues | ☐ | | | `prop_hs_margin_tcv` | `decimal` | Margin Total Contract Value | ☐ | | | `prop_hs_margin` | `decimal` | Margin | ☐ | | | `prop_hs_merged_object_ids` | `varchar2` | Merged Object IDs | ☐ | | | `prop_hs_mrr` | `decimal` | Monthly Recurring Revenues | ☐ | | | `prop_hs_object_id` | `decimal` | Object ID | ☐ | | | `prop_hs_object_source_detail_1` | `varchar2` | | ☐ | | | `prop_hs_object_source_detail_2` | `varchar2` | | ☐ | | | `prop_hs_object_source_detail_3` | `varchar2` | | ☐ | | | `prop_hs_object_source_id` | `varchar2` | | ☐ | | | `prop_hs_object_source_label` | `varchar2` | | ☐ | | | `prop_hs_object_source_user_id` | `decimal` | | ☐ | | | `prop_hs_object_source` | `varchar2` | | ☐ | | | `prop_hs_owning_teams` | `varchar2` | | ☐ | | | `prop_hs_parent_object_type_id` | `varchar2` | | ☐ | | | `prop_hs_pinned_engagement_id` | `decimal` | Pinned Engagement ID | ☐ | | | `prop_hs_position_on_quote` | `decimal` | Position on Quote | ☐ | | | `prop_hs_post_tax_amount` | `decimal` | | ☐ | | | `prop_hs_pre_discount_amount` | `decimal` | Pre-discount Amount | ☐ | | | `prop_hs_pricing_model` | `varchar2` | | ☐ | | | `prop_hs_product_id` | `decimal` | Product ID | ☐ | | | `prop_hs_product_type` | `varchar2` | Product Type | ☐ | | | `prop_hs_read_only` | `char` | Read-only | ☐ | | | `prop_hs_recurring_billing_day_of_month` | `decimal` | | ☐ | | | `prop_hs_recurring_billing_end_date` | `datetime` | Recurring Billing End Date | ☐ | | | `prop_hs_recurring_billing_number_of_payments` | `decimal` | Recurring Billing Number of Payments | ☐ | | | `prop_hs_recurring_billing_period` | `varchar2` | Recurring Billing Period | ☐ | | | `prop_hs_recurring_billing_start_date` | `datetime` | Recurring Billing Start Date | ☐ | | | `prop_hs_recurring_billing_terms` | `varchar2` | Recurring Billing Terms | ☐ | | | `prop_hs_shared_team_ids` | `varchar2` | | ☐ | | | `prop_hs_shared_user_ids` | `varchar2` | | ☐ | | | `prop_hs_sku` | `varchar2` | SKU | ☐ | | | `prop_hs_sync_amount` | `decimal` | Sync Amount | ☐ | | | `prop_hs_tax_amount` | `decimal` | | ☐ | | | `prop_hs_tax_assessed` | `char` | | ☐ | | | `prop_hs_tax_label` | `varchar2` | | ☐ | | | `prop_hs_tax_rate_group_id` | `varchar2` | | ☐ | | | `prop_hs_tax_rate` | `decimal` | | ☐ | | | `prop_hs_tcv` | `decimal` | Total Contract Value | ☐ | | | `prop_hs_term_in_months` | `decimal` | Term in Months | ☐ | | | `prop_hs_tier_amount` | `decimal` | | ☐ | | | `prop_hs_tier_prices` | `varchar2` | | ☐ | | | `prop_hs_tier_ranges` | `varchar2` | | ☐ | | | `prop_hs_total_discount` | `decimal` | Total Discount | ☐ | | | `prop_hs_unique_creation_key` | `varchar2` | Unique Creation Key | ☐ | | | `prop_hs_unscaled_amount` | `decimal` | | ☐ | | | `prop_hs_unscaled_pre_discount_amount` | `decimal` | | ☐ | | | `prop_hs_unscaled_total_discount` | `decimal` | | ☐ | | | `prop_hs_updated_by_user_id` | `decimal` | Updated by User ID | ☐ | | | `prop_hs_url` | `varchar2` | URL | ☐ | | | `prop_hs_user_ids_of_all_notification_followers` | `varchar2` | User IDs of All Notification Followers | ☐ | | | `prop_hs_user_ids_of_all_notification_unfollowers` | `varchar2` | User IDs of All Notification Unfollowers | ☐ | | | `prop_hs_user_ids_of_all_owners` | `varchar2` | User IDs of All Owners | ☐ | | | `prop_hs_variant_id` | `decimal` | Variant ID | ☐ | | | `prop_hs_was_imported` | `char` | Was Imported | ☐ | | | `prop_hubspot_owner_assigneddate` | `datetime` | Owner Assigned Date | ☐ | | | `prop_hubspot_owner_id` | `varchar2` | Owner ID | ☐ | | | `prop_hubspot_team_id` | `varchar2` | Team ID | ☐ | | | `prop_name` | `varchar2` | Name | ☐ | | | `prop_price` | `decimal` | Price | ☐ | | | `prop_quantity` | `decimal` | Quantity | ☐ | | | `prop_recurringbillingfrequency` | `varchar2` | Recurring Billing Frequency | ☐ | | | `prop_tax` | `decimal` | Tax | ☐ | | | `updatedAt` | `datetime` | Updated at | ☐ | The timestamp when the object was last updated, in ISO 8601 format. | | `url` | `varchar2` | URL | ☐ | The URL on the API that provide direct navigation to the corresponding UI pages for the connectors. |