Skip to main content
GET
List invoices for the organization

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