> ## 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.

# Supersubsidio: family compensation fund affiliations

> A person's affiliation history to Colombia's Cajas de Compensación Familiar over the last four years, from the Superintendencia del Subsidio Familiar: month, fund and employer, every fund in one call, plus the PDF.

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](https://docs.usecroma.com/live-lookups.md)

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`. |

```bash theme={"dark"}
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. |

> [!NOTE]
>
> 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.

> [!NOTE]
>
> Keeping the report's PDF takes a moment, so this lookup is an
> [async job](https://docs.usecroma.com/async-jobs.md). 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.

> [card] [Full reference](https://docs.usecroma.com/api-reference/overview.md)
>
> Schemas, all response fields, and an interactive playground.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.