> ## 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 the holder's death, straight from the Registraduría Nacional's official vital-status record.

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" }'
```

| Field | Notes |
| - | - |
| `found` | `true` when the cédula is in the registry; `false` when it isn't (then `status` is `null`). |
| `document_number` | The queried cédula, echoed back. |
| `status` | The vital status when found, `null` otherwise. |

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, all response fields, and an interactive playground.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.