Verify Colombian Affiliations

The Verify Colombian Affiliations service allows users to access detailed information about an individual's affiliations with various entities in Colombia.

By providing parameters such as document type, document number, and date, the service returns a response that includes personal information along with details about the individual's affiliations with EPS (healthcare provider), ARL (work-related risk insurance), AP (pension fund), caja de compensación (compensation fund), and cesantías (unemployment fund).

This service is particularly valuable for companies and organizations that need to verify an individual's affiliations in Colombia for purposes such as employment verification or benefits eligibility.

Parameters

Name	Type	¿Required?	Description	Example
documentType	String	`True`	Document type of the person to consult. Parameters: CC, PA, CE, PEP.	`CC`
documentNumber	String	`True`	Document number of the person to consult, without spaces or points.	`123456789`
date	String	`True`	Expedition date of the document, must be entered as follows: DD/MM/YYYY.	`05/05/2020`

Implementation

Request

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/co/afiliaciones>',
  params: {
		  documentType: 'CC', 
		  documentNumber: '123456789', 
		  date: '05/05/2022'
				  },
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  }
};

try {
 notFou const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Response 200 - (Successful response)

{
  "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": "EMPRESAS DEDICADAS A ACTIVIDADES DE LAS INSTITUCIONES PRESTADORAS DE SERVICIOS DE SALUD, CON INTERNACION INCLUYE HOSPITALES GENERALES, CENTROS DE ATENCIÓN MÉDICA CON AYUDAS DIAGNOSTICAS, INSTITUCIONES PRESTADORAS DE SERVICIOS DE SALUD, CENTROS ESPECIALIZADOS (EXCEPTO DE RADIODIAGNOSTICOS Y/O RADIOTERAPIA), HOSPITALES PARA TUBERCULOSOS, INSTITUCIONES DE SALUD MENTAL",
          "municipioLaboral": "Bogotá, D.C.- BOGOTÁ"
        },
        {
          "administradora": "RIESGOS PROFESIONALES COLMENA SA COMPAÑIA DE SEGUROS DE VIDA",
          "fecha": "2009-08-01",
          "estado": "Activa",
          "actividad": "EMPRESAS DEDICADAS A OTRAS ACTIVIDADES EMPRESARIALES NCP INCLUYE OFICINAS DE NEGOCIOS VARIOS TALES COMO COBRANZAS DE CUENTAS, ACTIVIDADES DE EVALUACIÓN EXCEPTO LAS RELACIONADAS CON BIENES RAÍCES Y NEGOCIOS, ACTIVIDADES DE INTERMEDIACIÓN Y PROMOCIÓN COMERCIAL, SUBASTAS, TRAMITACIÓN DE DOCUMENTOS, ACTIVIDADES DE REDACCIÓN, TRADUCCIÓN E INTERPRETACIÓN, ACTIVIDADES DE MICROFILMACIÓN, ACTIVIDADES DE DEMOSTRACIÓN Y EXHIBICIÓN INCLUSO LA PRESTACIÓN DE SERVICIOS PROFESIONALES, ACTIVIDADES DE AGENCIAS, DISEÑO DE TELAS PRENDAS DE VESTIR ETC",
          "municipioLaboral": "Bogotá, D.C.- BOGOTÁ"
        },
        {
          "administradora": "SEGUROS DE VIDA COLPATRIA SA",
          "fecha": "2012-02-15",
          "estado": "Activa",
          "actividad": "EMPRESAS DEDICADAS A ACTIVIDADES DE LAS INSTITUCIONES PRESTADORAS DE SERVICIOS DE SALUD, CON INTERNACION INCLUYE HOSPITALES GENERALES, CENTROS DE ATENCIÓN MÉDICA CON AYUDAS DIAGNOSTICAS, INSTITUCIONES PRESTADORAS DE SERVICIOS DE SALUD, CENTROS ESPECIALIZADOS (EXCEPTO DE RADIODIAGNOSTICOS Y/O RADIOTERAPIA), HOSPITALES PARA TUBERCULOSOS, INSTITUCIONES DE SALUD MENTAL",
          "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"
  }
}

Other response

	Code	Description	Response Body
`404`	Not Found	Information not found.	{
"code": "NotFound",
"message": "Record not found.",
"signature": {
"dateTime": "August 31, 2022 3:24 PM",
"message": "Certified by Verifik.co"
}
}
`409`	Conflict	Some parameters are missing.	{
"code": "MissingParameter",
"message": "missing documentType\n. missing documentNumber\n"
}
`409`	Conflict	Invalid documentType for this request.	{
"code": "MissingParameter",
"message": "documentType must be one of: [CC, PA, CE, PEP]"
}