> ## 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

> Check whether a Colombian cédula is active or cancelled due to death.

Queries the Registraduría Nacional to determine whether a Colombian cédula is
active or has been cancelled due to the holder's death.

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

| Field             | Type   | Notes                                                           |
| ----------------- | ------ | --------------------------------------------------------------- |
| `document_number` | string | **Required.** 5-12 digits, no leading zero (`^[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` is `true` when the cédula is in the registry and `false` when it isn't
(then `status` is `null`). When `found` is `true`, `status` is one of:

| `status`   | Meaning                                                                |
| ---------- | ---------------------------------------------------------------------- |
| `ALIVE`    | Cédula active.                                                         |
| `DECEASED` | Cancelled due to the holder's death.                                   |
| `UNKNOWN`  | Upstream returned a value Croma doesn't recognize (logged for review). |

<Note>
  A cédula that isn't in the registry is **not** a `404`; it's a normal `200`
  with `found: false`.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, response fields, and an interactive playground.
</Card>