# Consultar un CFDI de retenciones

> `GET https://api.cfdi.express/v1/retenciones/{id}` — Devuelve una constancia de retenciones: estatus, UUID, periodo, montos derivados, archivos y cancelación.

URL de esta página: https://cfdi.express/docs/api/obtener-retencion
Autenticación: requiere API key (`Authorization: Bearer sk_test_…` o `sk_live_…`)
Header `x-account-id`: indica la cuenta. Si no eres miembro, la respuesta es 403.

Desde la v1.43.0. Úsalo para seguir un timbrado que respondió 202 (`status: "stamping"`) y para leer las URLs firmadas cuando `files.status` pasa a `ready`.

Por MCP, `get_retencion` devuelve el mismo recurso.

### Parámetros de ruta

| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| `id` | string | sí | Id de la retención. |

## Ejemplos

### cURL

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

## Respuesta

### 200 OK

```json
{
  "id": "ret7k3q9x2m4v1t8p6d0n5cb",
  "object": "retencion",
  "livemode": false,
  "status": "stamped",
  "merchantId": "mkq2f8v3x1t7p9d4n6c0b5rz",
  "uuid": "9f1b2c3d-4e5f-4a6b-8c9d-0e1f2a3b4c5d",
  "serie": "RET",
  "folio": 42,
  "folioText": "202609C0042",
  "fecha": "2026-10-01T10:00:00",
  "cveRetenc": "26",
  "ejercicio": 2026,
  "mes": 9,
  "periodicidad": "02",
  "tipoServicio": "05",
  "montoTotOperacion": 1000,
  "montoTotRet": 360,
  "isrRetenido": 200,
  "ivaRetenido": 160,
  "ivaTrasladado": 160,
  "difIvaEntregadoPrestServ": 0,
  "comisiones": 150,
  "currency": "MXN",
  "files": { "status": "ready" },
  "stampedAt": "2026-10-01T16:00:10.512Z",
  "createdAt": "2026-10-01T16:00:08.907Z"
}
```

## Errores

| Status | code | Cuándo aparece |
|---|---|---|
| 401 | `unauthorized` | Falta el header Authorization o la llave es inválida. |
| 404 | `not_found` | La retención no existe en tu cuenta. |

## Notas

- El recurso también trae `receiver`, `servicios`, `impRetenidos` y `cancellation`. Los campos de `cancellation` no están detallados en el OpenAPI publicado: el acuse queda en ese objeto cuando el estatus es de cancelación.

## Relacionados

- [POST /v1/retenciones](https://cfdi.express/docs/api/timbrar-retencion) — Timbrar retención
- [POST /v1/retenciones/{id}/cancel](https://cfdi.express/docs/api/cancelar-retencion) — Cancelar retención
- [GET /v1/retenciones](https://cfdi.express/docs/api/listar-retenciones) — Listar retenciones

---

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