Registraduría

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}$`).

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).

A cédula that isn’t in the registry is not a 404; it’s a normal 200 with found: false.

Full reference

Schemas, response fields, and an interactive playground.

Get Started

Countries

Full reference