improved
Bills API improvements at the line item level
May 22nd, 2025
In the bills API endpoints, we have introduced the quantity
and price
fields at the line item level.
Field | Description |
---|---|
quantity | Bill line item unit quantity |
price | Bill 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.