Improved
Bills and Invoices API improvements
March 20th, 2026
Record status
In the bills and invoices API responses, we have introduced a new recordStatus field. This field provides record status information for bills and invoices. This information is useful when bills and invoices are set in the draft state with the BILL web app.
| Object | Possible recordStatus values |
|---|---|
| bills | ACTIVE, INACTIVE, DRAFT, or DRAFT_DELETED |
| invoices | ACTIVE, INACTIVE, or DRAFT |
In the responses, when recordStatus is ACTIVE, archived is set as false. For any other recordStatus value, archived is set as true.
User information
In the bills and invoices API responses, we have introduced a new createdBy field. This field provides the BILL-generated ID of the user that created the bill or invoice record.
See Bills and Invoices in the Guides section for more information.