List Bills
Retrieve a list of Bills.
This endpoint retrieves a list of all Bills for the given Account within the specified Organization. Optional filters can be applied such as by date range, lock status, or other attributes. The list can also be paginated for easier management.
Path parameters
The unique identifier (UUID) of your Organization. The Organization represents your company as a direct customer of our service.
Query parameters
Specifies the maximum number of Bills to retrieve per page.
The nextToken for multi-page retrievals. It is used to fetch the next page of Bills in a paginated list.
Optional filter. An Account ID - returns the Bills for the single specified Account.
Boolean flag specifying whether to include Bills with "locked" status.
- TRUE - the list inlcudes "locked" Bills.
- FALSE - excludes "locked" Bills from the list.
Exclude Line Items
Include Bill Total
Indicates whether the Bill has passed human/manual approval.
- Pending - Bill has not yet been passed by a human reviewer.
- Approved - Bill has been approved after manual review.
Only include Bills having the given status
The specific date in ISO 8601 format for which you want to retrieve Bills.
Only include Bills with bill dates equal to or later than this date.
Only include Bills with bill dates earlier than this date.
Only include Bills with external invoice dates equal to or later than this date.
Only include Bills with external invoice dates earlier than this date.
Optional filter. The list of Bill IDs to retrieve.
List Bill entities by the bill job that last calculated them.
Comma separated list of additional fields.
Response
Returns the requested list of Bills
Example response
{
"data": [
{
"timezone": "UTC",
"currencyConversions": [
{
"from": "EUR",
"to": "USD",
"multiplier": 1.12
}
]
}
]
}