ADRES (BDUA)

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

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

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.

This lookup can take longer than a typical request. It’s an async job. 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.

Full reference

Accepted document types, schemas, and an interactive playground.

Get Started

Countries

Full reference