Skip to main content

Invoice Line Items

Note that for merge tags for line items, the number in brackets in the merge tag corresponds to which line the item is on the invoice, quote, or subscription.

For example, if you want to see the name of the first line item on an invoice, you would use {{invoice.line_items[0].item_name}}.

If you wanted to see the name of the second line item, you would use the merge tag {{invoice.line_items[1].item_name}}.

Merge Tag

Type

Description

{{invoice.line_items[0].line_item_id}}integerInvoice Line ID #
{{invoice.line_items[0].invoice_id}}integerInvoice ID #
{{invoice.line_items[0].admin_id}}integerAdmin worker/sales rep ID #
{{invoice.line_items[0].item_id}}stringItem ID # for this line
{{invoice.line_items[0].item_name}}stringItem name
{{invoice.line_items[0].item_accounting_sku}}stringItem accounting SKU
{{invoice.line_items[0].item_external_key}}stringItem external key
{{invoice.line_items[0].item_token}}stringItem token
{{invoice.line_items[0].item_units}}stringItem units
{{invoice.line_items[0].item_type}}stringItem type
{{invoice.line_items[0].invoice_line_bundle_id}}integerInvoice line bundle ID #
{{invoice.line_items[0].paycycle}}stringPayment cycle
{{invoice.line_items[0].tierset_id}}integerTierset ID # for this line
{{invoice.line_items[0].package_line_id}}integerSubscription line ID # that this line originated from
{{invoice.line_items[0].package_line_external_key}}stringSubscription line external key
{{invoice.line_items[0].package_obligation_id}}integerThe contractual obligation this line counted towards
{{invoice.line_items[0].package_line_first_obligation_id}}integerThe ID # of the first contractual obligation for the subscription line that this line originated from
{{invoice.line_items[0].descrip}}stringDescription
{{invoice.line_items[0].line_rate}}floatRate
{{invoice.line_items[0].line_quantity}}floatQuantity
{{invoice.line_items[0].line_usage}}floatUsage Value
{{invoice.line_items[0].line_subtotal}}floatLine subtotal
{{invoice.line_items[0].line_total}}floatLine total
{{invoice.line_items[0].usage_from}}float
{{invoice.line_items[0].usage_to}}float
{{invoice.line_items[0].number_of_recurs_this}}integer# of times this has recurred since the last up/downgrade
{{invoice.line_items[0].number_of_recurs_line}}integer# of times this line has recurred
{{invoice.line_items[0].tax_taxable}}floatThe total amount that was taxable
{{invoice.line_items[0].tax_taxed}}floatThe amount that tax was calculated from
{{invoice.line_items[0].tax_total}}floatThe tax amount for this line
{{invoice.line_items[0].tax_id}}string
{{invoice.line_items[0].tax_group_id}}string
{{invoice.line_items[0].tax_name}}string
{{invoice.line_items[0].tax_group_name}}string
{{invoice.line_items[0].is_usage}}booleanWhether or not this line item was created from usage data
{{invoice.line_items[0].is_setup}}booleanWhether or not this line item was a one-time setup fee
{{invoice.line_items[0].is_base}}booleanWhether or not this line item is the base line item for other tiered/volume/unit lines
{{invoice.line_items[0].is_free}}booleanWhether or not this line item was free (equal to $0.00)
{{invoice.line_items[0].is_recurring}}booleanWhether or not this line is recurring
{{invoice.line_items[0].is_taxed}}booleanWhether or not this line item was taxed/subject to VAT
{{invoice.line_items[0].is_latefee}}booleanWhether or not this line item was a late fee
{{invoice.line_items[0].is_obligation}}booleanWhether or not this line item was towards a contractual obligation
{{invoice.line_items[0].custom_1}}mixedCustom field #1
{{invoice.line_items[0].custom_2}}mixedCustom field #2
{{invoice.line_items[0].custom_3}}mixedCustom field #3
{{invoice.line_items[0].custom_4}}mixedCustom field #4
{{invoice.line_items[0].custom_5}}mixedCustom field #5
{{invoice.line_items[0].custom_6}}mixedCustom field #6
{{invoice.line_items[0].custom_7}}mixedCustom field #7
{{invoice.line_items[0].custom_8}}mixedCustom field #8
{{invoice.line_items[0].custom_9}}mixedCustom field #9
{{invoice.line_items[0].custom_10}}mixedCustom field #10
{{invoice.line_items[0].custom_11}}mixedCustom field #11
{{invoice.line_items[0].custom_12}}mixedCustom field #12
{{invoice.line_items[0].custom_13}}mixedCustom field #13
{{invoice.line_items[0].custom_14}}mixedCustom field #14
{{invoice.line_items[0].custom_15}}mixedCustom field #15
{{invoice.line_items[0].custom_16}}mixedCustom field #16
{{invoice.line_items[0].custom_17}}mixedCustom field #17
{{invoice.line_items[0].custom_18}}mixedCustom field #18
{{invoice.line_items[0].custom_19}}mixedCustom field #19
{{invoice.line_items[0].custom_20}}mixedCustom field #20