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

> Consulte a afiliação de uma pessoa ao sistema de saúde na Colômbia por documento.

Consulta a afiliação de uma pessoa ao Sistema General de Seguridad Social en
Salud na Base de Datos Única de Afiliados (BDUA), a partir da ADRES.

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

| Campo             | Tipo   | Notas                                                                                       |
| ----------------- | ------ | ------------------------------------------------------------------------------------------- |
| `document_number` | string | **Obrigatório.** Entre 3 e 30 caracteres.                                                   |
| `document_type`   | enum   | Tipo de documento colombiano (`CC`, `TI`, `CE`, `RC`, `PA`, `PEP`, `PPT`). O padrão é `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" }'
```

A resposta reporta a identidade registrada e cada afiliação no registro:

| Campo                         | Notas                                                                                                                                                             |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `found`                       | `false` quando o documento não está registrado na BDUA; nesse caso os campos de identidade são `null` e `affiliations` fica vazio.                                |
| `full_name`                   | Nomes e sobrenomes registrados, ou `null` quando não é encontrado.                                                                                                |
| `department` / `municipality` | Localização registrada.                                                                                                                                           |
| `affiliations[]`              | Uma entrada por afiliação reportada: `entity` (a EPS), `regime` (`CONTRIBUTIVO`/`SUBSIDIADO`), `status`, `effective_date`, `termination_date` e `affiliate_type`. |

<Note>
  Uma `termination_date` de `31/12/2999` indica que a afiliação continua vigente
  com essa entidade. As informações de afiliação refletem o que a EPS reporta à
  ADRES.
</Note>

<Note>
  Esta consulta pode demorar mais que uma solicitação típica. É um
  [trabalho assíncrono](/pt/async-jobs). Por padrão a solicitação aguarda de forma
  síncrona e retorna `{ data }`, ou você pode fazer polling ou usar um `callback_url`. Os
  valores aceitos de `document_type` estão enumerados na referência da API.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Tipos de documento aceitos, esquemas e um playground interativo.
</Card>