Supersubsidio: family compensation fund affiliations

Every formal employer in Colombia affiliates its workers to a Caja de Compensación Familiar (CCF) and pays a contribution on their payroll each month. The Superintendencia del Subsidio Familiar, which supervises the cajas, keeps the affiliation history across all of them. This endpoint returns a person’s history over the last four years, month by month, with the caja and the employer that affiliated them: a view of their formal employment, which lenders, employers and background-check teams use to confirm where someone works and has worked. It needs the person’s document number, first surname and date of birth, and keeps a copy of the report’s PDF. POST /co/ssf/affiliation-history/v1 Live One person, by three facts that must all match the record. There is no need to name a caja: every caja comes back in one call.

Field	Type	Notes
`document_number`	string	Required. The person’s cédula de ciudadanía, digits only.
`first_surname`	string	Required. The first surname exactly as on the record. Case does not matter.
`birth_date`	string	Required. Date of birth, `yyyy-mm-dd`.

curl https://api.croma.run/co/ssf/affiliation-history/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "document_number": "1234567890",
        "first_surname": "PEREZ",
        "birth_date": "1990-01-01"
      }'

The response echoes the document number and carries the person’s history:

Field	Notes
`found`	`false` when no person matches the document number, first surname and date of birth together. A surname or date that does not match the record answers the same as an unknown document.
`full_name`, `document_type`	The person, as the report prints them.
`affiliate_type`	The kind of affiliate (a dependent worker, for example), as printed. The report can cut this text short.
`affiliations`	One row per month, fund and employer, oldest first, over the last four years on record: `period` (`yyyy-mm`), `fund` (the Caja de Compensación Familiar) and `employer` (`null` when the report names none). A month with two employers has two rows, and the history covers every fund the person was affiliated to.
`document_url`	Our copy of the affiliation history PDF, byte-identical to the one the source issued.
`source_document_url`	Always `null`: the source issues the report on request and publishes no link to it.

The report orients a request for a certificate; it is not an official certification. For a certificate of affiliation, or for history older than four years, ask the Caja de Compensación Familiar or the Superintendencia del Subsidio Familiar.

Keeping the report’s PDF takes a moment, so this lookup is an async job. By default the request waits inline and returns { data }, or you can poll or pass a callback_url. Most calls finish in a few seconds.

Full reference

Schemas, all response fields, and an interactive playground.

Get started

Request types

Monitors

Feedback

Countries

Supersubsidio: family compensation fund affiliations

Full reference