Skip to main content
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 of organizationId.
  • An API key (X-API-Key: sk_...) with the read:invoices scope — the key’s own organization must match organizationId in the URL, or the request is rejected with 403 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 of organizationId, 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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organizationId
string
required

Query Parameters

page
number

Page number (1-indexed). Default: 1

Example:

1

limit
number

Results per page (1-100). Default: 20

Example:

20

Response

data
object[]
required
total
number
required

Total de facturas de la organización, antes de paginar

Example:

42

page
number
required
Example:

1

limit
number
required
Example:

20

totalPages
number
required
Example:

3