Skip to main content
List invoices

Authorizations

Authorization
string
header
required

Personal API key from Settings → Personal → API keys. Send X-Organization-Id with the target organization. Plaintext is shown once at creation and cannot be recovered. Header: Authorization: Bearer wdg_<token>.

Headers

X-Organization-Id
string

Required for personal API keys. Target one organization you have access to. Migrated keys may omit it to use their original organization. For Clerk sessions, it must match the active organization.

Query Parameters

limit
integer
default:50

Maximum invoices to return. Defaults to 50 and cannot exceed 100.

Required range: 1 <= x <= 100
Example:

50

cursor
string

Opaque continuation cursor from the preceding response. It retains the selected sort and direction.

Required string length: 1 - 512
Example:

"eyJ2IjoxLCJyZXNvdXJjZSI6Imludm9pY2VzIiwic29ydCI6ImNyZWF0ZWRfYXQiLCJkaXJlY3Rpb24iOiJkZXNjIiwic29ydF92YWx1ZSI6IjE3ODY0NjM5NjAwNjEwMDAiLCJpZCI6IjdhZDJjNTBkLTJjYzAtNDlhMC05YTljLTZmYTgxN2MxZmJjYiJ9"

sort
enum<string>
default:created_at

Field used to order invoices. Defaults to created_at for an initial request and is inherited from the cursor on continuation.

Available options:
created_at
Example:

"created_at"

direction
enum<string>
default:desc

Sort direction. Defaults to desc for an initial request and is inherited from the cursor on continuation.

Available options:
asc,
desc
Example:

"desc"

Response

A page of invoices ordered by the selected field and invoice ID.

invoices
object[]
required
next_cursor
string | null
required

Opaque cursor for the next page, or null when no more invoices remain.