Uso mensual
GEThttps://api.cfdi.express/v1/billing/usageAPI key
Timbres consumidos y centavos gastados por mes, del más reciente al más antiguo.
Autenticación
Authorization: Bearer sk_test_... | sk_live_...Parámetros
Query string
| Campo | Tipo | Descripción |
|---|---|---|
| limit | integer | Meses a devolver. Entre 1 y 24. Default 12. |
Ejemplos
cURL
curl "https://api.cfdi.express/v1/billing/usage?limit=3" \
-H "Authorization: Bearer sk_live_..."Respuesta
200 OK
{
"object": "list",
"data": [
{
"object": "usage_month",
"month": "2026-08",
"livemode": true,
"timbres": 412,
"spentCentavos": 41200
},
{
"object": "usage_month",
"month": "2026-07",
"livemode": true,
"timbres": 388,
"spentCentavos": 38800
}
]
}Errores
| Status | code | Cuándo aparece |
|---|---|---|
| 401 | unauthorized | Falta el header Authorization o la llave es inválida. |
| 429 | rate_limited | Excediste el límite de requests por minuto de tu cuenta (300 por default). La respuesta incluye Retry-After. |