> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Registraduría

> Verifique se uma cédula colombiana está ativa ou cancelada por falecimento do titular, direto do registro de vigência da Registraduría Nacional da Colômbia.

Consulta a Registraduría Nacional para determinar se uma cédula colombiana está
ativa ou foi cancelada pelo falecimento do titular.

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

| Campo | Tipo | Notas |
| - | - | - |
| `document_number` | string | **Obrigatório.** 5-12 dígitos, sem zero à esquerda (`^[1-9]\d{4,11}$`). |

```bash theme={"dark"}
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` quando a cédula está no registro; `false` quando não está (nesse caso `status` é `null`). |
| `document_number` | A cédula consultada, devolvida tal qual. |
| `status` | O estado vital quando encontrada, `null` caso contrário. |

Quando `found` é `true`, `status` é um de:

| `status` | Significado |
| - | - |
| `ALIVE` | Cédula ativa. |
| `DECEASED` | Cancelada pelo falecimento do titular. |
| `UNKNOWN` | A fonte devolveu um valor que a Croma não reconhece (é registrado para revisão). |

<Note>
  Uma cédula que não está no registro **não** é um `404`; é um `200` normal
  com `found: false`.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.