Returns a list of accounts receivable documents - invoices, quotes, and credit notes - of the specified entity.
Results can be filtered by amount, counterpart, due date, and other criteria. Multiple filters are combined using logical AND unless specified otherwise. If no documents matching the search criteria are found, the endpoint returns a successful response with an empty data
array.
This endpoint supports pagination and sorting. By default, results are sorted by the creation date in ascending order (from oldest to newest).
Get all overdue invoices:
Get all invoices created for the counterpart named “Solarwind” (case-insensitive):
Get invoices whose total amount starts from 500 EUR:
Get invoices that are due for payment in September 2024:
Get invoices created on or after September 1, 2024:
Find an invoice created from a specific quote:
Get the latest created quote:
Get the latest issued quote:
Find all credit notes created for a specific invoice:
The ID of the entity that owns the requested resource.
Sort order (ascending by default). Typically used together with the sort
parameter.
The number of items (0 .. 100) to return in a single page of the response. The response may contain fewer items if it is the last or only page.
When using pagination with a non-default limit
, you must provide the limit
value alongside pagination_token
in all subsequent pagination requests. Unlike other query parameters, limit
is not inferred from pagination_token
.
A pagination token obtained from a previous call to this endpoint. Use it to get the next or previous page of results for your initial query. If pagination_token
is specified, all other query parameters except limit
are ignored and inferred from the initial query.
If not specified, the first page of results will be returned.
Return only receivables with the specified IDs. Valid but nonexistent IDs do not raise errors but produce no results.
To specify multiple IDs, repeat this parameter for each value:
id__in=<id1>&id__in=<id2>
Return only receivables that have the specified statuses. See the applicable invoice statuses, quote statuses, and credit note statuses.
To specify multiple statuses, repeat this parameter for each value:
status__in=draft&status__in=issued
Return only receivables created by the entity users with the specified IDs.To specify multiple user IDs, repeat this parameter for each ID:
entity_user_id__in=<user1>&entity_user_id__in=<user2>
If the request is authenticated using an entity user token, this user must have the receivable.read.allowed
(rather than allowed_for_own
) permission to be able to query receivables created by other users.
IDs of deleted users will still produce results here if those users had associated receivables. Valid but nonexistent user IDs do not raise errors but produce no results.
The field to sort the results by. Typically used together with the order
parameter.
Return only receivables whose tags include at least one of the tags with the specified IDs.
For example, given receivables with the following tags:
tag_ids__in=<tagA>&tag_ids__in=<tagB>
will return receivables 1, 2, 3, and 5.
Valid but nonexistent tag IDs do not raise errors but produce no results.
A token that can be sent in the pagination_token
query parameter to get the next page of results, or null
if there is no next page (i.e. you’ve reached the last page).
A token that can be sent in the pagination_token
query parameter to get the previous page of results, or null
if there is no previous page (i.e. you’ve reached the first page).