List invoices

Returns a cursor-paginated list of your organization's invoices. Paginate by passing the returned cursor back as the cursor query parameter until hasMore is false.

Cursor stability: cursors are stable against concurrent changes only when ordering by createdAt (the default). When ordering by dueDate, issueDate, or updatedAt, a row changed mid-pagination may be skipped or repeated — for a consistent snapshot, sort by createdAt.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
customerId
array of strings

Filter to invoices for a given customer (discover ids via GET /v1/customers). Repeat the parameter for multiple values (OR).

customerId
lifecycle
array of objects

Filter by lifecycle state. Repeat the parameter for multiple values (OR).

lifecycle
Allowed:
settlement
array of objects

Filter by settlement state. Repeat the parameter for multiple values (OR).

settlement
Allowed:
ticker
array of strings

Filter by currency ticker (e.g. USD, BTC, USDC), canonical uppercase. Repeat the parameter for multiple values (OR).

ticker
date-time

Only invoices due strictly before this instant (UTC). Exclusive upper bound.

date-time

Only invoices due at or after this instant (UTC). Inclusive lower bound.

date-time

Only invoices updated at or after this instant (UTC). For incremental sync, combine with orderByField=updatedAt.

date-time

Only invoices updated strictly before this instant (UTC).

int32
1 to 200
Defaults to 50

Maximum number of items to return. Defaults to 50; maximum 200.

string

Opaque pagination cursor returned as cursor in a previous response. Omit to fetch the first page.

string
enum
Defaults to createdAt

Field to order results by. Only createdAt is stable across pages while data changes.

Allowed:
string
enum
Defaults to ASC

Sort direction. Defaults to ASC.

Allowed:
Responses

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json