List invoices
Header Parameters
Query Parameters
Page number, starting at 1.
Results per page. Default 25, maximum 100.
One or more status codes, comma-separated (?status=A,P) or repeated (?status=A&status=P). An invalid code returns 400 listing the valid values. Codes: N new, O open, A approved, R rejected, RV revision, P pending, NI not an invoice, W wrong, 3WM three-way matched.
NOARRVPNIW3WMCase-insensitive substring match on title and invoice number only.
Exact invoice number.
Exact supplier number of the linked supplier.
Invoice date on or after this date (YYYY-MM-DD).
Invoice date on or before this date (YYYY-MM-DD).
Due date on or after this date (YYYY-MM-DD).
Due date on or before this date (YYYY-MM-DD).
Invoice updated at or after this ISO 8601 datetime. Send a UTC offset (2026-07-01T00:00:00Z); values without an offset are interpreted as server time. Not a complete change feed: changes to nested data do not bump updatedAt.
Invoice updated at or before this ISO 8601 datetime.
Filter by payment state: true or false.
Sort field, prefix with - for descending. One of createdAt, invoiceDate, dueDate, updatedAt, totalAmount. Default -createdAt. Ties are broken deterministically, so paging never skips or repeats invoices.
createdAt-createdAtinvoiceDate-invoiceDatedueDate-dueDateupdatedAt-updatedAttotalAmount-totalAmountPath Parameters
Company ID. Must be one of the IDs returned by GET /api/v2/companies/.
Response
Paginated list of invoices.
Response Attributes
Total matching records across all pages.
Total pages. 0 when there are no results.
The page this response contains.
Show child attributes
Invalid filter value. The body names the parameter and the accepted values.
Response Attributes
Missing, invalid, or expired API key, or a session credential was used instead of an API key.
Response Attributes
validationErrorclientErrorserverError Show child attributes
Authenticated but not entitled: the key's user is not an active member of this company, the External API feature (or the resource's own feature) is not enabled for it, the key lacks the scope this verb needs, or a browser session was used.
Response Attributes
validationErrorclientErrorserverError Show child attributes
Rate limit exceeded (60 requests per minute per API key). Retry after the number of seconds given in the message.
Response Attributes
validationErrorclientErrorserverError