RUAF

Looks up what a person is affiliated to across Colombia’s social-security system — health, pensions, occupational risk, severance and family-compensation funds — in the Ministerio de Salud’s Registro Único de Afiliados (RUAF). POST /co/ruaf/affiliations/v1

Field	Type	Notes
`document_type`	enum	Colombian document type (`CC`, `CE`, `TI`, `RC`, `PA`, `PEP`, `PPT`). Default `CC`.
`document_number`	string	Required. Colombian cédula. 5-12 digits.
`issue_date`	string	Required. Date the document was issued (`YYYY-MM-DD`). The register requires it and refuses the lookup when it does not match. For `TI` and `RC` it asks for the date of birth instead.

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" }'

The response echoes the document that was looked up and lists every affiliation the register holds for it, across subsystems:

Field	Notes
`found`	`false` when the register has no record for this document.
`issue_date_matches`	`false` when the register does not accept the document and `issue_date` together. It answers the same way whether the date is wrong or the document is not on file, so this alone does not tell those apart. Nothing else is returned in that case.
`document_type`	Document type the lookup used.
`document_type_label`	Readable label for `document_type`, e.g. “Cédula de Ciudadanía”.
`document_number`	Document number the lookup used.
`full_name`	Names and surnames on the register, or `null` when not found.
`sex`	Sex as the register reports it (`M` / `F`), or `null`.
`as_of`	The register’s own cut-off date for the report, as `YYYY-MM-DD`.
`affiliations`	Affiliations found. Empty array when the person has none.
`affiliations[].system`	Subsystem the affiliation belongs to: `Salud`, `Pensiones`, `Riesgos Laborales`, `Cesantías`, `Compensación Familiar`, `Pensionados` or `Programas de Asistencia Social`.
`affiliations[].entity_name`	Administrator the person is affiliated to.
`affiliations[].regime`	Regime or scheme, e.g. `Contributivo`, or `null`.
`affiliations[].status`	Affiliation status as the source words it, e.g. `Activo`, `Retirado`, or `null`.
`affiliations[].affiliate_type`	How the person is attached, e.g. `COTIZANTE`. Health only; `null` elsewhere.
`affiliations[].start_date`	Affiliation start date as `YYYY-MM-DD`, or `null`.
`affiliations[].economic_activity`	Employer’s economic activity. Occupational risk only; `null` elsewhere.
`affiliations[].location`	Department and municipality the affiliation is registered in, or `null`.
`checked_at`	ISO timestamp of when the answer was read.

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.

Full reference

Schemas, all response fields, and an interactive playground.

Get Started

Countries

Full reference