PEPS

Description

List of Politically exposed persons in Colombia.

HTTP method GET

Endpoint

https://8ehec73psb.execute-api.us-west-2.amazonaws.com/uat/identity/api/idv-govcheck/v1/co-identity/{cedula}/peps

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
cedula	✅	string	Colombia identity document.

Status code responses

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

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "b2345cfc7bee621e",
    "timestamp": "2023-05-15 11:59:35",
    "data": {
        "peps_oficial": [
            {
                "cargo": "Representante Legal",
                "cargo_descripcion": "Representante Legal Partido Social de Unidad Nacional  \"Partido de la U\"",
                "entidad": "Representantes de Partidos Politicos",
                "fecha_consulta": "2021-04-16",
                "nombre": "Álvaro Echeverry Londoño",
                "pais": "Colombia",
                "pep_desc": "Decreto 1674 de 2016 - Punto 14",
                "pep_score": "100",
                "tipo_pep": "Nacional",
                "url": "https://www.cne.gov.co/informacion-sobre-partidos-y-movimientos-politicos"
            }
        ]
    }
}

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