improved

Bills API improvements at the line item level

In the bills API endpoints, we have introduced the quantity and price fields at the line item level.

FieldDescription
quantityBill line item unit quantity
priceBill line item unit price. For a bill in an international currency (not USD), this value is in the local currency.

In the billLineItems array, when you set amount for a bill line item, BILL uses this value as the bill line item amount. You can now set quantity and price for BILL to calculate the bill line item amount. For example, if quantity is 2 and price is 79.99 for a bill line item, BILL calculates and displays the line item amount in the response as 159.98 (2 x 79.99).

In addition, we have introduced the customerId field at the line item level in the classifications object. You can now tag a bill line item with a customerId.

See POST /v3/bills in the API reference for more information.