Colombia — Consulta PEP (personas políticamente expuestas)
Este endpoint realiza cribado AML / cumplimiento: verifica si una persona natural o empresa colombiana figura como persona políticamente expuesta (PEP) en las fuentes integradas por Verifik, incluyendo detalle de declaraciones cuando la integración lo devuelve.
No es el PEP migratorio (Permiso Especial de Permanencia). Para el permiso de estadía ante Migración Colombia, usa Colombia — PEP (Permiso Especial de Permanencia).
Qué devuelve la API
- Si el sujeto tiene registros tipo PEP en el conjunto de datos integrado
- Entradas en
detail(declarante, entidad, cargo, tipo de publicación, fechas, estado) cuando la fuente las provee - Respuestas firmadas; los resultados pueden cachearse en el servidor
Referencia de API
Endpoint
GET https://api.verifik.co/v2/co/politically-exposed-persons
Envía documentType y documentNumber en la query. Solo está expuesto como GET.
Encabezados
| Nombre | Valor |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
Parámetros
| nombre | tipo | requerido | descripción |
|---|---|---|---|
documentType | string | sí | CC (persona natural) o NIT (empresa). |
documentNumber | string | sí | Número de documento o NIT sin espacios ni puntuación. |
Solicitud
- JavaScript
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/politically-exposed-persons", {
params: { documentType: "CC", documentNumber: "123456789" },
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/co/politically-exposed-persons"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CC", "documentNumber": "123456789"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
Respuesta
- 200
- 404
- 409
{
"data": {
"documentNumber": "123456789",
"documentType": "CC",
"detail": [
{
"declarant": "Juan Pérez",
"entity": "Ministerio de Hacienda",
"positionContractor": "Ministro",
"publicationType": "Declaración de Bienes",
"declaration": "12345",
"publicationDate": "15/03/2023",
"declarationStatus": "Activa"
}
]
},
"signature": {
"dateTime": "August 22, 2023 8:02 PM",
"message": "Certified by Verifik.co"
},
"id": "PEP001"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "documentType must be one of: [CC, NIT]"
}
Características
- Soporte CC y NIT para personas y empresas
- Campos estructurados de PEP / declaraciones cuando la fuente los entrega
- Apto para flujos KYC/AML en Colombia
Casos de uso
- Banca y fintech con debida diligencia reforzada
- Programas de cumplimiento que requieran identificación PEP
Notas
documentTypedebe serCCoNIT(validado por la API).- Un 404 suele indicar que no hubo coincidencia o la fuente no respondió.
- Colisión de nombres: aquí PEP = persona políticamente expuesta (AML), no el permiso migratorio en Colombia — PEP (Permiso Especial de Permanencia).