Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.croma.run/llms.txt

Use this file to discover all available pages before exploring further.

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/death-status/lookup/v1
FieldTypeNotes
document_numberstringRequired. 5–12 digits, no leading zero (^[1-9]\d{4,11}$).
curl https://api.croma.run/co/registraduria/death-status/lookup/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -d '{ "document_number": "5786287" }'
The response normalizes the cédula’s status into one of three values:
statusMeaning
ALIVECédula active.
DECEASEDCancelled due to the holder’s death.
UNKNOWNUpstream returned a value Croma doesn’t recognize (logged for review).
Returns 404 (resource_not_found) when the document number isn’t present in the upstream registry.

Full reference

Schemas, response fields, and an interactive playground.