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

> Encuentra dónde se inscribió un registro civil de nacimiento colombiano — la oficina, el serial y la fecha de inscripción — por primer apellido, primer nombre, sexo y fecha de nacimiento, de la Registraduría Nacional del Estado Civil.

Consulta un registro civil de nacimiento colombiano y devuelve la oficina en
la que se inscribió, su serial y su fecha de inscripción, buscando por primer
apellido, primer nombre, sexo y fecha de nacimiento.

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

| Campo            | Tipo   | Notas                                                                    |
| ---------------- | ------ | ------------------------------------------------------------------------ |
| `first_surname`  | string | **Obligatorio.** Primer apellido.                                        |
| `first_name`     | string | **Obligatorio.** Primer nombre.                                          |
| `sex`            | enum   | **Obligatorio.** `M` (masculino) o `F` (femenino).                       |
| `birth_date`     | string | **Obligatorio.** Fecha de nacimiento, aaaa-mm-dd (año 1900 o posterior). |
| `second_surname` | string | Opcional. Segundo apellido.                                              |
| `second_name`    | string | Opcional. 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` cuando un registro de nacimiento coincide; `false` cuando ninguno lo hace (entonces `records` queda vacío).       |
| `records`                       | Los registros civiles que coinciden. Una coincidencia exacta devuelve un único registro con todos sus datos.             |
| `records[].serial`              | Serial impreso en el registro civil.                                                                                     |
| `records[].document_number`     | NUIP / NIP / Tarjeta de Identidad del registro, cuando aparece.                                                          |
| `records[].full_name`           | Nombres y apellidos del registro, unidos.                                                                                |
| `records[].sex`                 | Sexo tal como lo reporta el registro.                                                                                    |
| `records[].record_type`         | Tipo de registro civil (`REGISTRO CIVIL DE NACIMIENTO`).                                                                 |
| `records[].registration_office` | Oficina donde se inscribió el registro. Presente en una coincidencia exacta; `null` en una fila de una lista con varios. |
| `records[].registered_at`       | Fecha de inscripción (aaaa-mm-dd), o `null`.                                                                             |

<Note>
  Una persona sin registro de nacimiento digitalizado **no** es un `404`; es un
  `200` normal con `found: false` y `records` vacío. Los seriales de nacimiento
  se digitalizaron progresivamente desde alrededor de 1970.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>