Skip to content

QuickBooks: Read a bill — response body — Bill Line item Amount, Custom Extensions, Description, Detail Type, Id, Item Based Expense Line Detail, Line Num, Linked Txn Item Based Expense Line Detail

Read a bill: response body, field Bill / Line / item / Amount, CustomExtensions, Description, DetailType, Id, ItemBasedExpenseLineDetail, LineNum, LinkedTxn / ItemBasedExpenseLineDetail. Complete fields and constraints for contract 2026-10-20.

API reference · Contract 2026-10-20

SDK schema: Read a bill — response body — Bill Line item Amount, Custom Extensions, Description, Detail Type, Id, Item Based Expense Line Detail, Line Num, Linked Txn Item Based Expense Line Detail

FieldTypePresenceDescription and constraints
$objectRootAdditional keys: allowed
BillableStatusstringOptionalThe billable status of the expense. This field is not updatable through an API request. The value automatically changes when an invoice is created. Valid values: Billable , NotBillable , HasBeenBilled
Read only: true
ClassRefModelOptionalExpand Read an item — response body — Item Class Ref
Reference to the Class associated with the expense. Available if Preferences.AccountingInfoPrefs.ClassTrackingPerLine is set to true . Query the Class name list resource to determine the appropriate Class object for this reference. Use Class.Id and Class.Name from that object for ClassRef.value and ClassRef.name , respectively.
CustomerRefModelOptionalExpand Read an item — response body — Item Class Ref
Reference to a customer or job. Query the Customer name list resource to determine the appropriate Customer object for this reference. Use Customer.Id and Customer.DisplayName from that object for CustomerRef.value and CustomerRef.name , respectively.
ItemRefModelOptionalExpand Read an item — response body — Item Class Ref
Reference to the Item. Query the Item name list resource to determine the appropriate Item object for this reference. Use Item.Id and Item.Name from that object for ItemRef.value and ItemRef.name , respectively. When a line lacks an ItemRef it is treated as documentation and the Line.Amount attribute is ignored. For France locales: The account associated with the referenced Item object is looked up in the account category list. If this account has same location as specified in the transaction by the TransactionLocationType attribute and the same VAT as in the line item TaxCodeRef attribute, then the item account is used. If there is a mismatch, then the account from the account category list that matches the transaction location and VAT is used. If this account is not present in the account category list, then a new account is created with the new location, new VAT code, and all other attributes as in the default account.
MarkupInfoModelOptionalExpand Read an invoice — response body — Invoice Line item Amount, Custom Extensions, Description, Detail Type, Id, Line Num, Sales Item Line Detail Sales Item Line Detail Markup Info
Markup information for the expense.
PriceLevelRefModelOptionalExpand Read an item — response body — Item Class Ref
Reference to the PriceLevel of the service or item for the line. Support for this element will be available in the coming months.
QtyJSONOptionalNumber of items for the line.
Decimal string
Qty (anyOf 1)JSONAlternative
Qty (anyOf 1) (anyOf 1)numberAlternative
Qty (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
Qty (anyOf 2)stringAlternative
TaxCodeRefModelOptionalExpand Read an item — response body — Item Class Ref
Reference to the TaxCode for this item. Query the TaxCode name list resource to determine the appropriate TaxCode object for this reference. Use TaxCode.Id and TaxCode.Name from that object for TaxCodeRef.value and TaxCodeRef.name , respectively.
TaxInclusiveAmtJSONOptionalThe total amount of the line item including tax.
Decimal string
TaxInclusiveAmt (anyOf 1)JSONAlternative
TaxInclusiveAmt (anyOf 1) (anyOf 1)numberAlternative
TaxInclusiveAmt (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
TaxInclusiveAmt (anyOf 2)stringAlternative
UnitPriceJSONOptionalUnit price of the subject item as referenced by ItemRef . Corresponds to the Rate column on the QuickBooks Online UI to specify either unit price, a discount, or a tax rate for item. If used for unit price, the monetary value of the service or product, as expressed in the home currency. If used for a discount or tax rate, express the percentage as a fraction. For example, specify 0.4 for 40% tax.
Decimal string
UnitPrice (anyOf 1)JSONAlternative
UnitPrice (anyOf 1) (anyOf 1)numberAlternative
UnitPrice (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
UnitPrice (anyOf 2)stringAlternative

Referenced models: Read an invoice — response body — Invoice Line item Amount, Custom Extensions, Description, Detail Type, Id, Line Num, Sales Item Line Detail Sales Item Line Detail Markup Info, Read an item — response body — Item Class Ref

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.