Skip to content

Rippling: Retrieve a specific bill payment — response body — line items item

Retrieve a specific bill payment: response body, field line_items / item. Complete fields and constraints for contract 2026-10-28.

API reference · Contract 2026-10-28

SDK schema: Retrieve a specific bill payment — response body — line items item

FieldTypePresenceDescription and constraints
$objectRoot
amortization_statusstringOptionalAmortization state. Null when not set.
Known values: NOT_STARTED, IN_PROGRESS, COMPLETED, ERROR
amortizedbooleanOptionalWhether this line is amortized.
amountobjectOptionalAmount of this split, in the merchant currency. The `value` is a decimal string.
amount.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
amount.valueJSONOptional
amount.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
amount.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
category_idstringOptionalID of the Spend category assigned to this split. No public API is currently available to retrieve this category; its name is in `category_name`.
category_namestringOptionalName of the spend category.
dimension_choicesobjectOptionalSelected dimension values, keyed by dimension ID. Includes department and work location.
Additional keys: see wildcard field
dimension_choices.*ModelAdditional keysExpand Retrieve a specific bill payment — response body — line items item dimension choices value
discountstringOptionalDiscount on the item as a percentage (`10.00` means 10%), as a decimal string. Null when not set.
end_datestringOptionalAmortization end date. Null when not set.
gl_amortization_schedulestringOptionalID of the amortization schedule in the connected accounting integration. No public API is currently available to retrieve it. Null when not set.
gl_amortization_templatestringOptionalID of the amortization template in the connected accounting integration. No public API is currently available to retrieve it. Null when not set.
gl_billablestringOptionalWhether this split is billed to `gl_customer` in the accounting system. `BILLABLE` means it is billed, `NOT_BILLABLE` means it is not. Null when not set.
Known values: BILLABLE, NOT_BILLABLE
gl_customerstringOptionalID of the customer record in the connected accounting integration. No public Rippling API is currently available to retrieve this accounting customer.
gl_tax_codestringOptionalRippling ID of the tax code synced from the connected accounting integration. No public API is currently available to retrieve it. Null when not set.
memostringOptionalMemo entered on this split.
prepaid_accountstringOptionalID of the prepaid account in the connected accounting integration. No public API is currently available to retrieve it. Null when not set.
priceobjectOptionalUnit price, in the merchant currency. The `value` is a decimal string. Null when not set.
price.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
price.valueJSONOptional
price.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
price.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
quantitystringOptionalItem quantity, as a decimal string. Null when not set.
quantity_unit_of_measurestringOptionalUnit for quantity, such as tons or seats. Null when quantity is not set.
start_datestringOptionalAmortization start date. Null when not set.
tax_amountobjectOptionalTax amount entered on the line, in the merchant currency. The `value` is a decimal string. Null when not set.
tax_amount.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
tax_amount.valueJSONOptional
tax_amount.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
tax_amount.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
tax_code_display_aliasstringOptionalDisplay name of the tax code. Null when not set.
termstringOptionalTerm length, as a decimal string. Null when not set.
term_unit_of_measurestringOptionalUnit for term: YEARS, QUARTERS, MONTHS, WEEKS, or DAYS. Null when term is not set.
Known values: YEARS, QUARTERS, MONTHS, WEEKS, DAYS
total_amortized_amountobjectOptionalAmount amortized so far, in the company’s headquarters currency. The `value` is a decimal string. Null when not set.
total_amortized_amount.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
total_amortized_amount.valueJSONOptional
total_amortized_amount.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
total_amortized_amount.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Referenced models: Retrieve a specific bill payment — response body — line items item dimension choices value

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.