Get CFDI usage/quota for the current billing month
Invoices
Get CFDI Usage
Authenticate with either a Supabase session (member of organizationId) or an API key (external integrations, requires the read:invoices scope). Returns how many CFDI the organization has stamped this calendar month (Mexico City time) against its plan’s included quota. cfdiIncluded/cfdiRemaining are null for the enterprise plan (unlimited).
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 withoutorganizationIdin the URL —GET /usageinstead ofGET /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 oforganizationId. - An API key (
X-API-Key: sk_...) with theread:invoicesscope — the key’s own organization must matchorganizationIdin the URL, or the request is rejected with403 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 oforganizationId, or the API key belongs to a different organization than the one in the URL.
404 Not Found
organizationId not found.Authorizations
API Key for authentication (format: sk_...)
Path Parameters
Response
Available options:
starter, pro, business, enterprise null = ilimitado (plan enterprise)
Example:
500
Example:
128
null = ilimitado (plan enterprise)
Example:
372
Example:
"2026-09-01T06:00:00.000Z"