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

# ADRES (BDUA)

> Look up a person's health-system affiliation in Colombia by document.

Looks up a person's affiliation to the Colombian health system (Sistema General
de Seguridad Social en Salud) in the Base de Datos Única de Afiliados (BDUA),
from ADRES.

`POST /co/adres/affiliation-status/v1`

| Field             | Type   | Notes                                                                                   |
| ----------------- | ------ | --------------------------------------------------------------------------------------- |
| `document_number` | string | **Required.** 3-30 chars.                                                               |
| `document_type`   | enum   | Colombian document type (`CC`, `TI`, `CE`, `RC`, `PA`, `PEP`, `PPT`). Defaults to `CC`. |

```bash theme={"dark"}
curl https://api.croma.run/co/adres/affiliation-status/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_type": "CC", "document_number": "1234567890" }'
```

The response reports the registered identity and every affiliation on record:

| Field                         | Notes                                                                                                                                                                 |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `found`                       | `false` when the document is not registered in BDUA; identity fields are then `null` and `affiliations` is empty.                                                     |
| `full_name`                   | Registered names and surnames, or `null` when not found.                                                                                                              |
| `department` / `municipality` | Registered location.                                                                                                                                                  |
| `affiliations[]`              | One entry per reported affiliation: `entity` (the EPS), `regime` (`CONTRIBUTIVO`/`SUBSIDIADO`), `status`, `effective_date`, `termination_date`, and `affiliate_type`. |

<Note>
  A `termination_date` of `31/12/2999` means the affiliation is still active with
  that entity. Affiliation data reflects what the EPS reports to ADRES.
</Note>

<Note>
  This lookup can take longer than a typical request. It's an
  [async job](/async-jobs). By default the request waits inline and returns
  `{ data }`, or you can poll / use a `callback_url`. The accepted `document_type`
  values are enumerated in the API reference.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Accepted document types, schemas, and an interactive playground.
</Card>