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

> Find where a Colombian birth civil registry was inscribed — the office, serial and inscription date — by first surname, first name, sex and date of birth, from the Registraduría Nacional del Estado Civil.

Looks up a Colombian birth civil registry and returns the office it was
inscribed at, its serial and inscription date, matched by first surname, first
name, sex and date of birth.

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

| Field            | Type   | Notes                                                         |
| ---------------- | ------ | ------------------------------------------------------------- |
| `first_surname`  | string | **Required.** First surname (primer apellido).                |
| `first_name`     | string | **Required.** First given name (primer nombre).               |
| `sex`            | enum   | **Required.** `M` (masculino) or `F` (femenino).              |
| `birth_date`     | string | **Required.** Date of birth, yyyy-mm-dd (year 1900 or later). |
| `second_surname` | string | Optional. Second surname (segundo apellido).                  |
| `second_name`    | string | Optional. Second given name (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"
      }'
```

| Field                           | Notes                                                                                                      |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `found`                         | `true` when a birth registry matches; `false` when none does (then `records` is empty).                    |
| `records`                       | The matching civil registries. One exact match returns a single, fully populated record.                   |
| `records[].serial`              | Serial printed on the civil registry.                                                                      |
| `records[].document_number`     | NUIP / NIP / Tarjeta de Identidad on the record, when listed.                                              |
| `records[].full_name`           | The record's names and surnames joined.                                                                    |
| `records[].sex`                 | Sex as the register reports it.                                                                            |
| `records[].record_type`         | Kind of civil registry (`REGISTRO CIVIL DE NACIMIENTO`).                                                   |
| `records[].registration_office` | Office the registry was inscribed at. Present on an exact match; `null` on a row from a multi-record list. |
| `records[].registered_at`       | Inscription date (yyyy-mm-dd), or `null`.                                                                  |

<Note>
  A person with no digitized birth registry is **not** a `404`; it's a normal
  `200` with `found: false` and an empty `records` list. Birth serials were
  digitized progressively from around 1970.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, all response fields, and an interactive playground.
</Card>