---
title: "Registraduría Vital Status"
method: POST
path: "/co/registraduria/vital-status/v1"
tags: ["Colombia", "Registraduría"]
---

# Registraduría Vital Status

`POST /co/registraduria/vital-status/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/registraduria/vital-status/v1`
- Auth: HTTP bearer

Check a Colombian cédula's vital status. Returns `found: false` if the cédula isn't in the registry; otherwise `status` is `ALIVE` or `DECEASED`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `document_number` string, required: Colombian cédula. 5-12 digits, no leading zero.

## Response `200`

Successful response

- VitalStatusResponse
  - `data` VitalStatusData, required
    - `found` boolean, required: Whether the cédula is in the registry. When false, `status` is null.
    - `document_number` string, required
    - `status` 'ALIVE' | 'DECEASED' | 'UNKNOWN', nullable, required: Normalized vigilance status when found. null when the cédula isn't in the registry. UNKNOWN = an upstream value Croma doesn't recognize.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)