Colombia — Afiliaciones de salud y seguridad social

Verifik devuelve datos de afiliación e información personal de una persona en Colombia a partir de fuentes oficiales de salud y seguridad social (incluido el flujo RUAF / SISPRO), usando tipo de documento, número y fecha de expedición. Suele incluir bloques de EPS, ARL, pensión (AP), caja de compensación y cesantías, además de datos personales cuando la fuente los provee.

Este endpoint es solo GET (parámetros en query). Úsalo para empleo, prestaciones y cumplimiento cuando la ley y tu política lo permitan.

Qué devuelve la API

• Resumen personal (nombres, línea de documento, sexo, fecha de corte) cuando exista
• EPS: régimen, fechas, estado, municipio, etc.
• ARL: riesgos con administradora, actividad, municipio
• Pensiones (AP): regímenes y administradoras
• Bloques de caja de compensación y cesantías (pueden ser listas vacías)
• Respuesta firmada por Verifik

Referencia de API

Endpoint

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

Solo GET por query; envía documentType, documentNumber y date (DD/MM/AAAA).

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parámetros

name	type	required	description
documentType	string	sí	Uno de CC, CE, PA, PE.
documentNumber	string	sí	Número sin espacios ni signos (longitud mínima validada por la API).
date	string	sí	Fecha de expedición del documento en DD/MM/AAAA.

Solicitud

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())

Respuesta

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

409

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

Características

• Tipos de documento válidos en validación: CC, CE, PA, PE
• Fecha de expedición en DD/MM/AAAA

Casos de uso

• Contratación y relación laboral
• Prestaciones y elegibilidad de beneficios

Notas

• date es la fecha de expedición del documento, no la fecha de nacimiento.
• La ruta está expuesta como GET con query (no hay POST en el backend actual).
• PE se refiere al permiso especial de permanencia según la integración, no a “PEP” (persona políticamente expuesta).
• Caídas de SISPRO/RUAF u otros fallos pueden devolver 409 u otros errores de servicio.
• Los datos pueden incluir información personal sensible; úsala solo donde la ley lo permita.