# Buscar claves de unidad

> `GET https://api.cfdi.express/v1/catalogs/units` — Búsqueda por palabra clave sobre el catálogo c_ClaveUnidad. Devuelve clave, nombre y símbolo.

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

Las más usadas en comercio: `H87` (pieza), `E48` (unidad de servicio), `ACT` (actividad), `KGM` (kilogramo).

### Query string

| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| `keyword` | string | no | Texto a buscar, de 1 a 120 caracteres. |
| `limit` | integer | no | Resultados a devolver. Entre 1 y 100. Default 20. |

## Ejemplos

### cURL

```bash
curl -G https://api.cfdi.express/v1/catalogs/units \
  -H "Authorization: Bearer sk_test_..." \
  --data-urlencode "keyword=pieza"
```

## Respuesta

### 200 OK

```json
{
  "object": "list",
  "data": [
    { "clave": "H87", "nombre": "Pieza", "simbolo": null },
    { "clave": "EA", "nombre": "Elemento", "simbolo": null }
  ]
}
```

## 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/products](https://cfdi.express/docs/api/catalogo-productos) — Claves de producto
- [POST /v1/invoices](https://cfdi.express/docs/api/timbrar-factura) — Timbrar factura

---

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