Colombia — Health & social security affiliations

Verifik returns affiliation and personal data for a Colombian individual from official health and social security sources (including RUAF / SISPRO flows), using document type, document number, and document issue date. Typical blocks include EPS (health), ARL (occupational risk), pension (AP), caja de compensación, and cesantías, plus personal fields when returned by the source.

This endpoint is GET-only (query parameters). Use it for employment, benefits, and compliance checks where this data is allowed.

What this API returns

• Personal summary (names, ID line, sex, cut-off date) when available
• EPS: regime, affiliation date, status, municipality, etc.
• ARL: risk entries with administrator, activity, municipality
• Pension (AP): pension regimes and administrators
• Caja de compensación and cesantías blocks (may be empty arrays)
• A signed Verifik response

API reference

Endpoint

GET https://api.verifik.co/v2/co/afiliaciones

Query-only GET; pass documentType, documentNumber, and date (DD/MM/YYYY).

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parameters

name	type	required	description
documentType	string	yes	One of CC, CE, PA, PE.
documentNumber	string	yes	Document number without spaces or punctuation (min. length enforced by API).
date	string	yes	Issue date of the document in DD/MM/YYYY.

Request

JavaScript

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/afiliaciones", {
	params: {
		documentType: "CC",
		documentNumber: "123456789",
		date: "05/05/2020",
	},
	headers: {
		Accept: "application/json",
		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
	},
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/afiliaciones"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CC", "documentNumber": "123456789", "date": "05/05/2020"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Response

200

{
	"data": {
		"informaciónPersonal": {
			"fechaCorte": "2022-08-19",
			"documentoIdentidad": "CC 123456789",
			"primerNombre": "MATEO",
			"segundoNombre": "",
			"primerApellido": "VERIFIK",
			"segundoApellido": "",
			"sexo": "M"
		},
		"eps": {
			"fechaCorte": "2022-08-19",
			"eps": "FAMISANAR E.P.S. LTDA - CAFAM - COLSUBSIDIO -CM",
			"regimen": "Subsidiado",
			"fechaAfiliacion": "01/09/2020",
			"estadoAfiliacion": "Activo",
			"tipoAfiliado": "CABEZA DE FAMILIA",
			"departamentoMunicipio": "BOGOTA D.C."
		},
		"ap": {
			"fechaCorte": "2022-08-19",
			"pensiones": [
				{
					"regimenPensional": "PENSIONES: AHORRO INDIVIDUAL",
					"administradoraPensional": "SOCIEDAD ADMINISTRADORA DE FONDOS DE PENSIONES Y CESANTIAS PORVENIR SA",
					"fechaAfiliacionPensional": "1996-03-01",
					"estadoPensional": "Inactivo"
				}
			]
		},
		"arl": {
			"fechaCorte": "2022-08-19",
			"riesgos": [
				{
					"administradora": "POSITIVA COMPAÑIA DE SEGUROS",
					"fecha": "2016-09-01",
					"estado": "Activa",
					"actividad": "…",
					"municipioLaboral": "Bogotá, D.C.- BOGOTÁ"
				}
			]
		},
		"cajaCompensacion": {
			"fechaCorte": "2022-08-19",
			"cajas": []
		},
		"cesantias": {
			"fechaCorte": "2022-08-19",
			"cesantias": []
		}
	},
	"signature": {
		"dateTime": "August 30, 2022 2:49 PM",
		"message": "Certified by Verifik.co"
	}
}

404

{
	"code": "NotFound",
	"message": "Record not found."
}

404 - Incorrect date

{
	"code": "NotFound",
	"message": "The expedition date is incorrect."
}

409 - Missing Parameters

{
	"code": "MissingParameter",
	"message": "documentType must be one of [CC, CE, PA, PE]"
}

409 - Connection

{
	"code": "Conflict",
	"message": "Unable to connect to the source. Please try again later."
}

Features

• Supported document types at validation: CC, CE, PA, PE
• Issue date must match DD/MM/YYYY

Use cases

• Employment and contractor onboarding
• Benefits and payroll eligibility checks

Notes

• date is the document issue date, not the date of birth.
• This route is exposed as GET with query parameters only (no POST in the current backend).
• PE is permiso especial de permanencia (as used in the integration), not “PEP” in the sense of politically exposed persons.
• A 404 (record not found or incorrect expedition date) is billed. Connection failures (captcha, timeout, or upstream outage) return 409 with Unable to connect to the source. Please try again later. and are not billed.
• Response fields can include special-category personal data; use only where permitted by law and policy.