Skip to main content
GET
Get CFDI usage/quota for the current billing month
Returns how many CFDI the organization has stamped this calendar month (Mexico City time) against its plan’s included quota.
API key only: you can also call this without organizationId in the URL — GET /usage instead of GET /organizations/{organizationId}/usage — when authenticating with an API key. The organization is resolved from the key. This form rejects session auth (403).

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

Example Request

cURL
TypeScript SDK

Example Response

Common Errors

401 Unauthorized

Missing or invalid Bearer token / API key.

403 Forbidden

The authenticated user is not a member of organizationId, or the API key belongs to a different organization than the one in the URL.

404 Not Found

organizationId not found.

Authorizations

X-API-Key
string
header
required

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

Path Parameters

organizationId
string
required

Response

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

null = ilimitado (plan enterprise)

Example:

500

cfdiUsedThisMonth
number
required
Example:

128

cfdiRemaining
object | null
required

null = ilimitado (plan enterprise)

Example:

372

periodResetsAt
string
required
Example:

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