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.
This endpoint takes no organizationId in the URL. Authenticate with either a Supabase Bearer session (send the X-Organization-Id: <org-id> header — the user must be a member of that organization) or an API key (the organization resolves automatically from the key; any X-Organization-Id header sent alongside an API key is ignored).

Authentication

Accepts either:
  • A Supabase Bearer session (Authorization: Bearer <token>) with the X-Organization-Id: <org-id> header — the authenticated user must be a member of that organization.
  • An API key (X-API-Key: sk_...) with the read:invoices scope — the organization is resolved from the key itself.

Query Parameters

Example Request

cURL
TypeScript SDK
With an API key, omit the X-Organization-Id header (and the SDK’s organizationId argument) entirely — it’s resolved from the key:
TypeScript SDK (API key)

Example Response

data[]

This is a summary shape — it does not include the CFDI XML or line items. To re-fetch the full XML of a previously stamped invoice, use Get Invoice (returned inline as JSON) or Download Invoice XML (returned as a raw file download). For the full cancellation history of an invoice (not just the latest attempt), see List Invoice Cancellations.

Common Errors

400 Bad Request

Missing X-Organization-Id header on a session-authenticated request.

401 Unauthorized

Missing or invalid Bearer token / API key.

403 Forbidden

The authenticated user is not a member of the organization sent in X-Organization-Id, or the API key does not have the read:invoices scope.

Authorizations

X-API-Key
string
header
required

API Key for authentication (format: sk_...)

Headers

X-Organization-Id
string

Required for Supabase session auth. Ignored when authenticating with an API key (the organization resolves from the key).

Query Parameters

page
number
default:1

Page number (1-indexed)

Example:

1

limit
number
default:20

Results per page (1-100)

Example:

20

type
enum<string>

Filtra por tipo de comprobante

Available options:
I,
E,
T
status
enum<string>

Filtra por estatus

Available options:
vigente,
cancelado
dateFrom
string

Filtra por fecha de registro en Timbrix (createdAt), desde (inclusive, ISO 8601). Un valor de solo fecha (YYYY-MM-DD) se ancla al inicio del día en America/Mexico_City.

Example:

"2026-08-01"

dateTo
string

Filtra por fecha de registro en Timbrix (createdAt), hasta (inclusive, ISO 8601). Un valor de solo fecha (YYYY-MM-DD) se ancla al final del día (23:59:59.999) en America/Mexico_City, incluyendo el día completo.

Example:

"2026-08-31"

rfcReceptor
string

Filtra por RFC exacto del receptor

Example:

"XAXX010101000"

environment
enum<string>

Filtra por entorno. Ignorado para peticiones autenticadas con API key (siempre se usa el entorno de la key). Para una sesión de Supabase, omitir este parámetro devuelve ambos entornos.

Available options:
sandbox,
production

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