ADRES (BDUA)

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

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

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.

Esta consulta puede tardar más que una solicitud típica. Es un trabajo asíncrono. 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.

Referencia completa

Tipos de documento aceptados, esquemas y un playground interactivo.

Primeros pasos

Países

Referencia completa