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

> Consulta la afiliación de una persona al sistema de salud en Colombia por documento.

Consulta la afiliación de una persona al Sistema General de Seguridad Social en
Salud en la Base de Datos Única de Afiliados (BDUA), desde la ADRES.

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

| Campo             | Tipo   | Notas                                                                                           |
| ----------------- | ------ | ----------------------------------------------------------------------------------------------- |
| `document_number` | string | **Obligatorio.** Entre 3 y 30 caracteres.                                                       |
| `document_type`   | enum   | Tipo de documento colombiano (`CC`, `TI`, `CE`, `RC`, `PA`, `PEP`, `PPT`). Por defecto es `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" }'
```

La respuesta reporta la identidad registrada y cada afiliación en el registro:

| Campo                         | Notas                                                                                                                                                               |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `found`                       | `false` cuando el documento no está registrado en BDUA; en ese caso los campos de identidad son `null` y `affiliations` está vacío.                                 |
| `full_name`                   | Nombres y apellidos registrados, o `null` cuando no se encuentra.                                                                                                   |
| `department` / `municipality` | Ubicación registrada.                                                                                                                                               |
| `affiliations[]`              | Una entrada por afiliación reportada: `entity` (la EPS), `regime` (`CONTRIBUTIVO`/`SUBSIDIADO`), `status`, `effective_date`, `termination_date` y `affiliate_type`. |

<Note>
  Una `termination_date` de `31/12/2999` indica que la afiliación sigue vigente
  con esa entidad. La información de afiliación refleja lo que la EPS reporta a la
  ADRES.
</Note>

<Note>
  Esta consulta puede tardar más que una solicitud típica. Es un
  [trabajo asíncrono](/es/async-jobs). Por defecto la solicitud espera en línea y
  devuelve `{ data }`, o puedes hacer polling o usar un `callback_url`. Los valores
  aceptados de `document_type` están enumerados en la referencia de la API.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Tipos de documento aceptados, esquemas y un playground interactivo.
</Card>