> ## 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.
# RUAF
> Consulta las afiliaciones a la seguridad social de una persona en Colombia por documento.
Consulta a qué está afiliada una persona en el sistema de seguridad social
colombiano (salud, pensiones, riesgos laborales, cesantías y cajas de
compensación) en el Registro Único de Afiliados (RUAF) del Ministerio de Salud.
`POST /co/ruaf/affiliations/v1`
| Campo | Tipo | Notas |
| ----------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `document_type` | enum | Tipo de documento colombiano (`CC`, `CE`, `TI`, `RC`, `PA`, `PEP`, `PPT`). Por defecto `CC`. |
| `document_number` | string | **Obligatorio.** Cédula colombiana. 5-12 dígitos. |
| `issue_date` | string | **Obligatorio.** Fecha de expedición del documento (`YYYY-MM-DD`). El registro la exige y rechaza la consulta cuando no coincide. Para `TI` y `RC` corresponde a la fecha de nacimiento. |
```bash theme={"dark"}
curl https://api.croma.run/co/ruaf/affiliations/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "document_number": "1234567890", "issue_date": "2008-02-15" }'
```
La respuesta repite el documento consultado y lista cada afiliación que el
registro tiene a su nombre, en todos los subsistemas:
| Campo | Notas |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `found` | `false` cuando el registro no tiene información para este documento. |
| `issue_date_matches` | `false` cuando el registro no acepta el documento junto con la `issue_date`. Responde igual cuando la fecha es incorrecta y cuando el documento no está registrado, así que por sí solo no distingue ambos casos. En ese caso no se devuelve más información. |
| `document_type` | Tipo de documento usado en la consulta. |
| `document_type_label` | Etiqueta legible de `document_type`, por ejemplo "Cédula de Ciudadanía". |
| `document_number` | Número de documento usado en la consulta. |
| `full_name` | Nombres y apellidos en el registro, o `null` cuando no se encuentra. |
| `sex` | Sexo tal como lo reporta el registro (`M` / `F`), o `null`. |
| `as_of` | Fecha de corte del reporte según el registro, en formato `YYYY-MM-DD`. |
| `affiliations` | Afiliaciones encontradas. Arreglo vacío cuando la persona no tiene ninguna. |
| `affiliations[].system` | Subsistema al que corresponde la afiliación: `Salud`, `Pensiones`, `Riesgos Laborales`, `Cesantías`, `Compensación Familiar`, `Pensionados` o `Programas de Asistencia Social`. |
| `affiliations[].entity_name` | Administradora a la que está afiliada la persona. |
| `affiliations[].regime` | Régimen o modalidad, por ejemplo `Contributivo`, o `null`. |
| `affiliations[].status` | Estado de la afiliación tal como lo reporta la fuente, por ejemplo `Activo`, `Retirado`, o `null`. |
| `affiliations[].affiliate_type` | Tipo de afiliado, por ejemplo `COTIZANTE`. Solo en salud; `null` en los demás. |
| `affiliations[].start_date` | Fecha de afiliación en formato `YYYY-MM-DD`, o `null`. |
| `affiliations[].economic_activity` | Actividad económica del empleador. Solo en riesgos laborales; `null` en los demás. |
| `affiliations[].location` | Departamento y municipio donde está registrada la afiliación, o `null`. |
| `checked_at` | Marca de tiempo ISO de cuándo se leyó la respuesta. |
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 / usar un `callback_url`.
Esquemas, todos los campos de respuesta y un playground interactivo.