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
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Additional keys: allowed |
BillableStatus | string | Optional | The 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 |
ClassRef | Model | Optional | Expand 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. |
CustomerRef | Model | Optional | Expand 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. |
ItemRef | Model | Optional | Expand 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. |
MarkupInfo | Model | Optional | Expand 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. |
PriceLevelRef | Model | Optional | Expand 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. |
Qty | JSON | Optional | Number of items for the line. Decimal string |
Qty (anyOf 1) | JSON | Alternative | |
Qty (anyOf 1) (anyOf 1) | number | Alternative | |
Qty (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
Qty (anyOf 2) | string | Alternative | |
TaxCodeRef | Model | Optional | Expand 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. |
TaxInclusiveAmt | JSON | Optional | The total amount of the line item including tax. Decimal string |
TaxInclusiveAmt (anyOf 1) | JSON | Alternative | |
TaxInclusiveAmt (anyOf 1) (anyOf 1) | number | Alternative | |
TaxInclusiveAmt (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
TaxInclusiveAmt (anyOf 2) | string | Alternative | |
UnitPrice | JSON | Optional | Unit 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) | JSON | Alternative | |
UnitPrice (anyOf 1) (anyOf 1) | number | Alternative | |
UnitPrice (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
UnitPrice (anyOf 2) | string | Alternative |
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