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
Read a bill: response body, field Bill / Line / item / Amount, CustomExtensions, Description, DetailType, Id, ItemBasedExpenseLineDetail, LineNum, LinkedTxn. 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
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Additional keys: allowed |
Amount | JSON | Optional | The amount of the line item. Decimal string |
Amount (anyOf 1) | JSON | Alternative | |
Amount (anyOf 1) (anyOf 1) | number | Alternative | |
Amount (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
Amount (anyOf 2) | string | Alternative | |
CustomExtensions | Model | Optional | Expand Read an item — response body — Item Custom Extensions Array of custom extension objects that associate additional attributes with the line. The ExtensionType field specifies the type of extension. The currently supported value is DIMENSION . The AssociatedValues array contains key/value pairs referencing Dimensions DefinitionID/Dimension ValueID. Multiple key/value pairs per extension type are supported. This field is designed to support additional extension types in the future. Dimensions is available for Intuit Enterprise Suite. |
Description | string | Optional | Free form text description of the line item that appears in the printed record. |
DetailType | string | Optional | Set to ItemBasedExpenseLineDetail for this type of line. |
Id | string | Optional | The Id of the line item. Its use in requests is as folllows: If Id is greater than zero and exists for the company, the request is considered an update operation for a line item. If no Id is provided, the Id provided is less than or equal to zero, or the Id provided is greater than zero and does not exist for the company then the request is considered a create operation for a line item. Available in all objects that use lines and support the update operation. Read only: true |
ItemBasedExpenseLineDetail | Model | Optional | Expand 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 |
LineNum | JSON | Optional | Specifies the position of the line in the collection of transaction lines. Positive integer. Decimal string |
LineNum (anyOf 1) | JSON | Alternative | |
LineNum (anyOf 1) (anyOf 1) | number | Alternative | |
LineNum (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
LineNum (anyOf 2) | string | Alternative | |
LinkedTxn | array | Optional | Zero or more transactions linked to this object. The LinkedTxn.TxnType can be set to PurchaseOrder or it can also be set to ReimburseCharge . Use LinkedTxn.TxnId as the ID of the transaction. When updating an existing Bill to link to a PurchaseOrder a new Line must be created. This behavior matches the QuickBooks UI as it does not allow the linking of an existing line, but rather a new line must be added to link the PurchaseOrder. Over the API this is achieved by simply updating the Bill Line.Id to something new. This will ensure old bill line is deleted and the new line is linked to the PurchaseOrder. Be aware that for this PurchaseOrder-Bill linking to work all LinkedTxn child attributes are required. See child attributes below. |
LinkedTxn[] | Model | Each item | Expand Read a bill — response body — Bill Linked Txn item |
Referenced models: Read an item — response body — Item Custom Extensions, 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 — Bill Linked Txn item