# Uso mensual

> `GET https://api.cfdi.express/v1/billing/usage` — Timbres consumidos y centavos gastados por mes, del más reciente al más antiguo.

URL de esta página: https://cfdi.express/docs/api/uso-mensual
Autenticación: requiere API key (`Authorization: Bearer sk_test_…` o `sk_live_…`)

### Query string

| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| `limit` | integer | no | Meses a devolver. Entre 1 y 24. Default 12. |

## Ejemplos

### cURL

```bash
curl "https://api.cfdi.express/v1/billing/usage?limit=3" \
  -H "Authorization: Bearer sk_live_..."
```

## Respuesta

### 200 OK

```json
{
  "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. |

## Relacionados

- [GET /v1/balance](https://cfdi.express/docs/api/saldo) — Consultar saldo
- [GET /v1/billing/transactions](https://cfdi.express/docs/api/transacciones) — Transacciones de saldo

---

Referencia completa: https://cfdi.express/docs/api · OpenAPI: https://api.cfdi.express/openapi.json · Llaves: https://dash.cfdi.express