Colombia — PEP (Permiso Especial de Permanencia)

Verifik valida registros de PEP publicados por Migración Colombia para KYC, elegibilidad y cumplimiento.

Qué devuelve esta API

• Estado (p. ej. VIGENTE / VENCIDO) y fechas clave, incluidas expedición y vencimiento cuando la fuente las entrega
• Nombre estructurado, metadatos del documento PEP e identificación venezolana cuando aplica
• Respuestas firmadas y posible caché

Referencia de API

Endpoint

GET https://api.verifik.co/v2/co/foreigner-id/pep

La misma integración está disponible como POST con cuerpo JSON con los mismos campos. En GET usa parámetros de query como abajo.

Encabezados

Nombre	Valor
Accept	application/json
Authorization	Bearer <token>

Parámetros

nombre	tipo	requerido	descripción
documentNumber	string	sí	Número PEP sin espacios ni puntuación.
expeditionDate	string	sí	Fecha de expedición en DD/MM/AAAA (p. ej. 10/10/2024).

Solicitud

JavaScript

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/foreigner-id/pep", {
	params: {
		documentNumber: "123456789",
		expeditionDate: "10/10/2024",
	},
	headers: {
		Accept: "application/json",
		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
	},
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/foreigner-id/pep"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentNumber": "123456789", "expeditionDate": "10/10/2024"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Respuesta

200

{
	"data": {
		"arrayName": ["MATEO", "VERIFIK"],
		"documentNumber": "123456789012345",
		"documentType": "PEP",
		"expirationDate": "08/08/2018",
		"firstName": "MATEO",
		"fullName": "MATEO VERIFIK",
		"identification": "17609583",
		"lastName": "VERIFIK",
		"status": "VENCIDO"
	},
	"signature": {
		"dateTime": "August 22, 2023 8:02 PM",
		"message": "Certified by Verifik.co"
	},
	"id": "tnlkb"
}

404

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

409

{
	"code": "MissingParameter",
	"message": "expeditionDate must be a valid date in DD/MM/YYYY format"
}

Características

• Consulta oficial de PEP contra el flujo de Migración Colombia
• Vigencia y fechas cuando la fuente las devuelve

Casos de uso

• Empleo, banca y servicios para connacionales venezolanos con PEP en Colombia
• Programas humanitarios que requieran acreditar estancia

Notas

• expeditionDate debe estar en DD/MM/AAAA; formatos incorrectos suelen devolver 409.
• GET y POST comparten el mismo manejador; usa POST si prefieres JSON en el cuerpo.
• Cambios en el portal o indisponibilidad pueden producir 404 / 500.