Verificar Afiliaciones Colombianas

Endpoint

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

El servicio Verificar Afiliaciones Colombianas permite a los usuarios acceder a información detallada sobre las afiliaciones de un individuo con varias entidades en Colombia.

Al proporcionar parámetros como tipo de documento, número de documento y fecha, el servicio devuelve una respuesta que incluye información personal junto con detalles sobre las afiliaciones del individuo con EPS (proveedor de salud), ARL (seguro de riesgos laborales), AP (fondo de pensiones), caja de compensación (fondo de compensación) y cesantías (fondo de desempleo).

Este servicio es particularmente valioso para empresas y organizaciones que necesitan verificar las afiliaciones de un individuo en Colombia para propósitos como verificación de empleo o elegibilidad de beneficios.

Headers

Nombre	Valor
Content-Type	`application/json`
Authorization	`Bearer <token>`

Parámetros

Nombre	Tipo	Requerido	Descripción	Ejemplo
documentType	String	Sí	Tipo de documento de la persona a consultar. Parámetros: CC, PA, CE, PEP.	`CC`
documentNumber	String	Sí	Número de documento de la persona a consultar, sin espacios ni puntos.	`123456789`
date	String	Sí	Fecha de expedición del documento, debe ingresarse de la siguiente manera: DD/MM/YYYY.	`05/05/2020`

Solicitud

JavaScript
Python
PHP
Swift

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 {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")

headers = {
    'Accept': "application/json",
    'Authorization': "JWT token"
}

conn.request("GET", "/v2/co/afiliaciones?documentType=CC&documentNumber=123456789&date=05/05/2022", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.verifik.co/v2/co/afiliaciones?documentType=CC&documentNumber=123456789&date=05/05/2022', [
  'headers' => [
    'Accept' => 'application/json',
    'Authorization' => 'JWT token',
  ],
]);

echo $response->getBody();

import Foundation

let headers = [
  "Accept": "application/json",
  "Authorization": "JWT token"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.verifik.co/v2/co/afiliaciones?documentType=CC&documentNumber=123456789&date=05/05/2022")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

Respuesta

200
404
409 (Parámetros Faltantes)
409 (Tipo de Documento Inválido)

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

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

{
  "code": "MissingParameter",
  "message": "missing documentType\n. missing documentNumber\n"
}

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

Características

Verificación de Afiliaciones: Verificar afiliaciones con EPS, ARL, AP, cajas de compensación y cesantías
Información Personal: Acceder a información personal del individuo
Estado de Afiliaciones: Verificar el estado actual de todas las afiliaciones
Información Laboral: Acceder a información sobre empleadores y actividades laborales
Información de Salud: Verificar afiliación a EPS y régimen de salud
Información de Pensiones: Verificar afiliación a fondos de pensiones
Información de Riesgos: Verificar afiliación a ARL y actividades laborales
Respuesta Estructurada: Formato de datos organizado para fácil integración
Múltiples Lenguajes de Programación: Soporte para JavaScript, Python, PHP y Swift
Manejo de Errores: Respuestas de error comprensivas para varios escenarios

Casos de Uso

Verificación de Empleo: Verificar afiliaciones laborales para procesos de contratación
Elegibilidad de Beneficios: Verificar afiliaciones para determinar elegibilidad de beneficios
Debida Diligencia: Verificar afiliaciones para procesos de debida diligencia
Cumplimiento Regulatorio: Cumplir con requisitos regulatorios para verificación de afiliaciones
Verificación de Identidad: Verificar información personal y afiliaciones del individuo

Endpoint​

Headers​

Parámetros​

Solicitud​

Respuesta​

Características​

Casos de Uso​