Colombia β Politically exposed persons (PEP) lookup
This endpoint performs AML / compliance screening: it checks whether a Colombian natural person or business appears in politically exposed persons (PEP) sources used by Verifik, including declaration-related detail when returned by the integration.
This is not the immigration PEP (Permiso Especial de Permanencia). For MigraciΓ³n Colombiaβs special stay permit, use Colombia β PEP (Special Stay Permit).
What this API returnsβ
- Whether the subject has PEP-related records in the integrated dataset
detailentries (e.g. declarant, entity, position, publication type, dates, status) when the source provides them- Signed responses; results may be cached server-side for repeat lookups
API referenceβ
Endpointβ
GET https://api.verifik.co/v2/co/politically-exposed-persons
Send documentType and documentNumber as query parameters. This route is exposed as GET only.
Headersβ
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
Parametersβ
| name | type | required | description |
|---|---|---|---|
documentType | string | yes | CC (natural person) or NIT (company). |
documentNumber | string | yes | Document or NIT number without spaces or punctuation. |
Requestβ
- 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())
Responseβ
- 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]"
}
Featuresβ
- CC and NIT support for individuals and companies
- Structured PEP / declaration-style fields when returned by the source
- Suitable for KYC/AML workflows that require PEP identification in Colombia
Use casesβ
- Banks and fintech applying enhanced due diligence
- Compliance programs that must screen Colombian IDs against PEP datasets
Notesβ
documentTypemust be exactlyCCorNIT(validated by the API).- A 404 often means no PEP record was found for that query (or upstream data is unavailable).
- Naming collision: PEP here means politically exposed person (AML), not the immigration permit documented under Colombia β PEP (Special Stay Permit).