> ## 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
> Consulte as filiações à seguridade social de uma pessoa na Colômbia por documento.
Consulta a que uma pessoa está filiada no sistema de seguridade social
colombiano (saúde, pensões, riscos ocupacionais, rescisão e caixas de
compensação) no Registro Único de Afiliados (RUAF) do 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 padrão `CC`. |
| `document_number` | string | **Obrigatório.** Cédula colombiana. 5-12 dígitos. |
| `issue_date` | string | **Obrigatório.** Data de emissão do documento (`YYYY-MM-DD`). O registro a exige e recusa a consulta quando não coincide. Para `TI` e `RC` corresponde à data de nascimento. |
```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" }'
```
A resposta repete o documento consultado e lista cada filiação que o registro
mantém em seu nome, em todos os subsistemas:
| Campo | Notas |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `found` | `false` quando o registro não tem informação para este documento. |
| `issue_date_matches` | `false` quando o registro não aceita o documento junto com a `issue_date`. Responde da mesma forma quando a data está errada e quando o documento não consta, então por si só não distingue os dois casos. Nesse caso nada mais é retornado. |
| `document_type` | Tipo de documento usado na consulta. |
| `document_type_label` | Rótulo legível de `document_type`, por exemplo "Cédula de Ciudadanía". |
| `document_number` | Número do documento usado na consulta. |
| `full_name` | Nomes e sobrenomes no registro, ou `null` quando não encontrado. |
| `sex` | Sexo conforme reportado pelo registro (`M` / `F`), ou `null`. |
| `as_of` | Data de corte do relatório segundo o registro, no formato `YYYY-MM-DD`. |
| `affiliations` | Filiações encontradas. Array vazio quando a pessoa não tem nenhuma. |
| `affiliations[].system` | Subsistema da filiação: `Salud`, `Pensiones`, `Riesgos Laborales`, `Cesantías`, `Compensación Familiar`, `Pensionados` ou `Programas de Asistencia Social`. |
| `affiliations[].entity_name` | Administradora à qual a pessoa está filiada. |
| `affiliations[].regime` | Regime ou modalidade, por exemplo `Contributivo`, ou `null`. |
| `affiliations[].status` | Situação da filiação conforme reportada pela fonte, por exemplo `Activo`, `Retirado`, ou `null`. |
| `affiliations[].affiliate_type` | Tipo de filiado, por exemplo `COTIZANTE`. Apenas em saúde; `null` nos demais. |
| `affiliations[].start_date` | Data de filiação no formato `YYYY-MM-DD`, ou `null`. |
| `affiliations[].economic_activity` | Atividade econômica do empregador. Apenas em riscos ocupacionais; `null` nos demais. |
| `affiliations[].location` | Departamento e município onde a filiação está registrada, ou `null`. |
| `checked_at` | Timestamp ISO de quando a resposta foi lida. |
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 / usar um `callback_url`.
Esquemas, todos os campos de resposta e um playground interativo.