🇨🇴ColombiaPOST /v1/co/defunciones

Registraduría ID status check

Check whether a Colombian national ID is still active or has been cancelled by death. Direct from the Registraduría's national identification archive.

Tomás Calle

Founder · Croma

This is a public demo with a reduced rate limit. For a production API key, book a call. I get back the same day.

tomas@usecroma.com+57 317 512 6894

Book 15 min

Integration guide

Source: Registraduría Nacional del Estado Civil of Colombia.
Freshness: On-demand lookup against the official source when the endpoint runs.
Latency: Usually seconds; depends on upstream availability.
Auth: Bearer API key in the Authorization header.

Best for

Verify the validity of Colombian national IDs.
Detect documents cancelled by death.
Automate identity checks in onboarding or compliance.

Request fields

document_numberstringreq: Colombian national ID, between 5 and 12 digits.

Response fields

document_numberstring: ID number queried.
statusstring: Status reported by the source (active, cancelled by death, etc.).
queried_atstring: Date the query ran (YYYY-MM-DD).

Frequently asked

What is the Deaths API for?

It checks whether a Colombian national ID is still active or appears as cancelled by death in the official archive.

Does the response include any extra sensitive data?

No. The response is limited to the queried document, its status and the query date.

Try it

Result

Edit the JSON and submit to verify validity.

Reference

curl https://api.usecroma.com/v1/co/defunciones \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"document_number":"1020812345"}'