PEPS

Description

Query on the official list of Politically Exposed Persons (PEP) registered by state entities in the Administrative Department of Public Service in Colombia, regulated by Decree 830 of 2021 (amending Decree 1081 of 2015) and Law 2013 of 2019.

HTTP method GET

Endpoint

https://api.msla-id.com/experience-background-pep-api-v1/api/idv-govcheck/v1/co-identity/{documentNumber}/peps

[SANDBOX Environment]

For testing purposes, use the base domain: apidev.msla-id.com

info

Before proceeding, make sure you have your jwt token, if you don't have it, check the login documentation.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

URI request parameter

NAME	REQUIRED	TYPE	DESCRIPTION
documentNumber	✅	string	Colombia identity document.

Status code responses

Code	Description
200	OK
400	Bad request
401	Unauthorized
404	Not found
500	Internal server error.
504	Gateway timeout.

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "1ad18cf4cc9abf51",
    "timestamp": "2026-09-18 15:03:46",
    "data": {
        "officialPeps": [
            {
                "documentNumber": "70856200",
                "fullName": "ACXAN DUQUE GAMEZ",
                "positionTitle": "DIRECTOR ADMINISTRATIVO Y O FINANCIERO O TECNICO U OPERATIVO",
                "entityName": "UNIDAD ADMINISTRATIVA ESPECIAL DE GESTION DE RESTITUCION DE TIERRAS DESPOJADAS",
                "appointmentDate": "2023-05-18",
                "dismissalDate": "2025-02-05",
                "declaration": {
                    "isContractor": "NO",
                    "spouseFirstName": "HEYLY",
                    "spouseLastName": "MOSQUERA",
                    "hasForeignBankAccounts": "NO",
                    "hasTrusts": "NO",
                    "publicationDate": "2026-01-23T16:39"
                }
            }
        ]
    }
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-4005",
    "message": "-",
    "data": null
}

Response 401 status code

{
    "timestamp": "YYYY-MM-DDTHH:mm:ss.sssZ",
    "status": 401,
    "error": "Unauthorized",
    "path": "/api/idv-govcheck/v1/co-identity/{cedula}/peps"
}

Response 400 status code

{
    "traceId": "c392ae46786ccb62",
    "timestamp": "2026-09-18 15:04:54",
    "code": "IDV-PEP01",
    "message": "The provided document is not a valid Colombian Citizenship Card",
    "data": null
}

{
    "traceId": "542fc743fffda052",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-3001",
    "message": "Bad request - Invalid or incomplete input data",
    "data": null
}

Response 404 status code

{
    "traceId": "ef2407b8c0df635c",
    "timestamp": "2023-05-22 17:25:55",
    "code": "IDV-1002",
    "message": "Data not found."
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1001",
    "message": "A generic error has occurred.",
    "data": null
}

### Response 504 status code
```json
{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1100",
    "message": "Gateway Timeout",
    "data": null
}