# Usos de CFDI

> `GET https://api.cfdi.express/v1/catalogs/usos-cfdi` — Catálogo completo c_UsoCFDI, con banderas de si aplica a persona física, moral o ambas.

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

Úsalo para poblar el selector de uso de CFDI de tu checkout: filtra por `fisica` o `moral` según el RFC del receptor.

## Ejemplos

### cURL

```bash
curl https://api.cfdi.express/v1/catalogs/usos-cfdi \
  -H "Authorization: Bearer sk_test_..."
```

## Respuesta

### 200 OK

```json
{
  "object": "list",
  "data": [
    { "clave": "G01", "nombre": "Adquisición de mercancías", "fisica": true, "moral": true },
    { "clave": "G03", "nombre": "Gastos en general", "fisica": true, "moral": true },
    { "clave": "S01", "nombre": "Sin efectos fiscales", "fisica": true, "moral": true },
    { "clave": "D01", "nombre": "Honorarios médicos, dentales y gastos hospitalarios", "fisica": true, "moral": false }
  ]
}
```

## 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/catalogs/regimenes](https://cfdi.express/docs/api/catalogo-regimenes) — Regímenes fiscales
- [GET /v1/catalogs/formas-pago](https://cfdi.express/docs/api/catalogo-formas-pago) — Formas de pago

---

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