> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Registraduría

> Verifica si una cédula colombiana está activa o cancelada por fallecimiento.

Consulta la Registraduría Nacional para determinar si una cédula colombiana está
activa o ha sido cancelada por el fallecimiento de su titular.

`POST /co/registraduria/vital-status/v1`

| Campo             | Tipo   | Notas                                                                       |
| ----------------- | ------ | --------------------------------------------------------------------------- |
| `document_number` | string | **Obligatorio.** 5-12 dígitos, sin cero a la izquierda (`^[1-9]\d{4,11}$`). |

```bash theme={"dark"}
curl https://api.croma.run/co/registraduria/vital-status/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "5786287" }'
```

`found` es `true` cuando la cédula está en el registro y `false` cuando no lo
está (en ese caso `status` es `null`). Cuando `found` es `true`, `status` es uno
de:

| `status`   | Significado                                                                    |
| ---------- | ------------------------------------------------------------------------------ |
| `ALIVE`    | Cédula activa.                                                                 |
| `DECEASED` | Cancelada por el fallecimiento del titular.                                    |
| `UNKNOWN`  | La fuente devolvió un valor que Croma no reconoce (se registra para revisión). |

<Note>
  Una cédula que no está en el registro **no** es un `404`; es un `200` normal
  con `found: false`.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, campos de respuesta y un playground interactivo.
</Card>