List invoices for the organization
Invoices
List Invoices
Authenticate with either a Supabase session (internal dashboard, member of organizationId) or an API key with the read:invoices scope. When using an API key, organizationId in the URL must match the key’s organization. Results are ordered by creation date, newest first.
GET
List invoices for the organization
Returns a paginated list of invoices for the organization, ordered by creation date, newest first.
Authentication
Accepts either:- A Supabase Bearer session (
Authorization: Bearer <token>) — the authenticated user must be a member oforganizationId. - An API key (
X-API-Key: sk_...) with theread:invoicesscope — the key’s own organization must matchorganizationIdin the URL, or the request is rejected with403 Forbidden.
Path Parameters
Query Parameters
Example Request
cURL
TypeScript SDK
Example Response
data[]
This is a summary shape — it does not include the CFDI XML or line items. The full XML is only returned in the Create Invoice response at issuance time; there is currently no endpoint to re-fetch the XML of a previously stamped invoice, so store it on your side if you need it later.
Common Errors
401 Unauthorized
Missing or invalid Bearer token / API key.403 Forbidden
The authenticated user is not a member oforganizationId, the API key does not have the read:invoices scope, or the API key belongs to a different organization than the one in the URL.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
Page number (1-indexed). Default: 1
Example:
1
Results per page (1-100). Default: 20
Example:
20