Registraduría

Consulta la Registraduría Nacional para determinar si una cédula colombiana está activa o ha sido cancelada por el fallecimiento de su titular. POST /co/registraduria/vital-status/v1

Campo	Tipo	Notas
`document_number`	string	Obligatorio. 5-12 dígitos, sin cero a la izquierda (`^[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" }'

Campo	Notas
`found`	`true` cuando la cédula está en el registro; `false` cuando no lo está (en ese caso `status` es `null`).
`document_number`	La cédula consultada, devuelta tal cual.
`status`	El estado vital cuando se encuentra, `null` en caso contrario.

Cuando found es true, status es uno de:

`status`	Significado
`ALIVE`	Cédula activa.
`DECEASED`	Cancelada por el fallecimiento del titular.
`UNKNOWN`	La fuente devolvió un valor que Croma no reconoce (se registra para revisión).

Una cédula que no está en el registro no es un 404; es un 200 normal con found: false.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.

Primeros pasos

Países

Referencia completa