> ## 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.

# Registro Civil

> Encontre onde foi inscrito um registro civil de nascimento colombiano — o cartório, o serial e a data de inscrição — por primeiro sobrenome, primeiro nome, sexo e data de nascimento, da Registraduría Nacional del Estado Civil da Colômbia.

Consulta um registro civil de nascimento colombiano e devolve o cartório em
que foi inscrito, seu serial e sua data de inscrição, buscando por primeiro
sobrenome, primeiro nome, sexo e data de nascimento.

`POST /co/registro-civil/birth-record/v1`

| Campo            | Tipo   | Notas                                                                    |
| ---------------- | ------ | ------------------------------------------------------------------------ |
| `first_surname`  | string | **Obrigatório.** Primeiro sobrenome (primer apellido).                   |
| `first_name`     | string | **Obrigatório.** Primeiro nome (primer nombre).                          |
| `sex`            | enum   | **Obrigatório.** `M` (masculino) ou `F` (femenino).                      |
| `birth_date`     | string | **Obrigatório.** Data de nascimento, aaaa-mm-dd (ano 1900 ou posterior). |
| `second_surname` | string | Opcional. Segundo sobrenome (segundo apellido).                          |
| `second_name`    | string | Opcional. Segundo nome (segundo nombre).                                 |

```bash theme={"dark"}
curl https://api.croma.run/co/registro-civil/birth-record/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "first_surname": "PEREZ",
        "first_name": "JUAN",
        "sex": "M",
        "birth_date": "1990-01-01"
      }'
```

| Campo                           | Notas                                                                                                                      |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `found`                         | `true` quando um registro de nascimento coincide; `false` quando nenhum coincide (então `records` fica vazio).             |
| `records`                       | Os registros civis que coincidem. Uma coincidência exata devolve um único registro com todos os dados.                     |
| `records[].serial`              | Serial impresso no registro civil.                                                                                         |
| `records[].document_number`     | NUIP / NIP / Tarjeta de Identidad do registro, quando consta.                                                              |
| `records[].full_name`           | Nomes e sobrenomes do registro, unidos.                                                                                    |
| `records[].sex`                 | Sexo conforme o registro reporta.                                                                                          |
| `records[].record_type`         | Tipo de registro civil (`REGISTRO CIVIL DE NACIMIENTO`).                                                                   |
| `records[].registration_office` | Cartório/ofício onde o registro foi inscrito. Presente numa coincidência exata; `null` numa linha de uma lista com vários. |
| `records[].registered_at`       | Data de inscrição (aaaa-mm-dd), ou `null`.                                                                                 |

<Note>
  Uma pessoa sem registro de nascimento digitalizado **não** é um `404`; é um
  `200` normal com `found: false` e `records` vazio. Os seriais de nascimento
  foram digitalizados progressivamente a partir de cerca de 1970.
</Note>

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