Skip to main content
GET

Overview

Returns a page of invoices. The common uses are finding what is outstanding and finding what is overdue โ€” those are different queries, and only the second one is about time.

Query

integer
Maximum results to return. Defaults to 50.
integer
Number of results to skip. Defaults to 0.
string
Filter by customer ID (UUID).
string
Filter by order ID (UUID).
string
Filter by status: draft, sent, viewed, paid, overdue, or voided.
string
Filter by type: standard, credit_note, pro_forma, or recurring.
boolean
Return only overdue invoices.
string
Invoices created on or after this date (RFC 3339).
string
Invoices created on or before this date (RFC 3339).

Response

array
required
The invoices, each shaped as in Get Invoice.
integer
Total matching invoices, for computing how many pages remain.
This endpoint paginates with limit and offset, not a cursor. Offset paging over a set that is changing underneath you can skip or repeat rows โ€” invoices move between sent, paid, and overdue continuously. Narrow with status or a from_date/to_date window so each page is drawn from a more stable set, and treat a full walk as approximate rather than exact.