Skip to main content
GET
Get CFDI usage/quota for the current billing month

Authorizations

X-API-Key
string
header
required

API Key for authentication (sk_test_... for sandbox, sk_live_... for production)

Headers

X-Organization-Id
string

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

Response

plan
enum<string>
required
Available options:
starter,
pro,
business,
enterprise
cfdiIncluded
object | null
required

null = ilimitado (plan enterprise)

Example:

500

cfdiUsedThisMonth
number
required

CFDI de producción del mes de todas las organizaciones de la cuenta de facturación (el cupo es compartido), incluidas las cerradas en el mes.

Example:

128

cfdiRemaining
object | null
required

null = ilimitado (plan enterprise)

Example:

372

periodResetsAt
string
required
Example:

"2026-09-01T06:00:00.000Z"

usagePct
number
required
Example:

70.5

projectedCostMxn
object | null
required

Costo estimado del excedente este mes en MXN — null en el plan enterprise

Example:

25

cfdiByChannelThisMonth
object
required

CFDI emitidos este mes (America/Mexico_City) por canal de origen, sumando sandbox y producción, solo de esta organización. unknown = CFDI sin canal registrado.

Example:
byOrganization
object[]
required

CFDI de producción del mes por organización de la cuenta de facturación, por nombre (abiertas, y cerradas que emitieron este mes). Solo el dueño de la cuenta, con sesión de usuario, ve las demás organizaciones; con API key o como miembro se ve solo esta organización.