Get a list of invoices
Retrieves a cursor-paginated list of a customer’s invoices, fetched live from the connected billing provider. Ordered by issue date ascending by default; override with orderBy (issueDate | dueDate | total) and orderDir (ASC | DESC). Optionally narrowed to one contract, an issue-date range, and/or a set of invoice states. Returns an empty list when no billing provider is connected or the customer is not synced.
Authorizations
Server API Key
Headers
Account ID — optional when authenticating with a user JWT (Bearer token); falls back to the user's first membership. Ignored for API-key auth.
Environment ID — required when authenticating with a user JWT (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is intrinsic to the key).
Path Parameters
External ID of the customer the invoice belongs to: your customer ref when mapped, otherwise the Received customer ID
1 - 255^[a-zA-Z0-9][a-zA-Z0-9_|.@-]*$Query Parameters
Maximum number of items to return
1 <= x <= 100Return items that come after this cursor
255Return items that come before this cursor
255Filter to invoices for this contract only (contract external ID or Received contract ID). Omit for all contracts.
255Filter by invoice state. Supports comma-separated values for multiple states
255Filter to invoices issued on or after this date, inclusive (ISO 8601)
Filter to invoices issued on or before this date, inclusive (ISO 8601)
Field to sort by: issueDate (default), dueDate, or total
issueDate, dueDate, total Sort direction: ASC (default) or DESC
ASC, DESC 