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


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