ADRES

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, y lo que el propietario de un vehículo le debe a la ADRES por las víctimas de un accidente sin SOAT.

Afiliación al sistema de salud

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

Campo	Tipo	Notas
`document_type`	enum	Tipo de documento colombiano (`CC`, `TI`, `CE`, `RC`, `PA`, `PEP`, `PPT`). Por defecto es `CC`. Por defecto `CC`.
`document_number`	string	Obligatorio. Entre 3 y 30 caracteres.

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.

Deudas por accidentes sin SOAT

POST /co/adres/uninsured-accident-debts/v1 Live

Campo	Tipo	Notas
`document_number`	string	Obligatorio. Cédula o NIT colombiano. Entre 5 y 12 dígitos, sin ceros iniciales.

curl https://api.croma.run/co/adres/uninsured-accident-debts/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "1234567890" }'

Campo	Notas
`found`	`false` cuando no hay deuda; los demás campos quedan en `null` o vacíos.
`full_name`	A quién se emite el estado de cuenta.
`total_owed`	En COP.
`claims[]`	Una por reclamación: `plate`, `accident_date`, `payment_date`, `total_value`, `paid`, `balance`, `status` y el documento del propietario. Todas, sean cuantas sean.

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.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.

Primeros pasos

Tipos de solicitud

Monitores

Comentarios

Países

Afiliación al sistema de salud

Deudas por accidentes sin SOAT

Referencia completa

​Afiliación al sistema de salud

​Deudas por accidentes sin SOAT

Referencia completa

Afiliación al sistema de salud

Deudas por accidentes sin SOAT