Social Security-COLPENSIONES

Description

Check the social security data of affiliated persons. The Colombian Pension Administrator - Colpensiones, is a state-owned industrial and commercial company, organized as a special financial entity, linked to the Ministry of Labor and its purpose is the state administration of the Average Premium Regime with Defined Benefit and the administration of the Savings System of Periodic Economic Benefits.

HTTP method GET

Endpoint

https://api.msla-id.com/experience-idv-socialsecurity-api-v1/api/idv-govcheck/v1/co-identity/{documentType}/{documentNumber}/adres

[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
documentType	✅	string	Document code.
documentNumber	✅	string	Cédula de Identidad/Passport.

Status code responses

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

Colombia Document Type

Code	Document Type
CC	Cédula de Ciudadanía (CC)
TI	Tarjeta de Identidad (TI)
CE	Cédula de Extranjería (CE)
RC	Registro Civil (RC)
PS	Pasaporte
NU	Número Único de Identidad Personal
AI	Adulto Sin Identificación
MI	Menor Sin Identificación
CD	Carnet Diplomático
NI	NIT

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "aa97d967111a3487",
    "timestamp": "2026-10-14 10:28:26",
    "data": {
        "status": "ACTIVO",
        "entity": "NUEVA EPS S.A.",
        "regime": "CONTRIBUTIVO",
        "affiliationDate": "2014-05-01",
        "affiliationFinalDate": "2999-12-31",
        "department": "SANTANDER",
        "city": "BUCARAMANGA",
        "affiliateType": "COTIZANTE"
    }
}

Response 400 status code

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

{
    "traceId": "a7b05ef110b81458",
    "timestamp": "2026-10-14 10:19:18",
    "code": "IDV-PRO01",
    "message": "The provided DocumentType is not supported. It must be one of: CC, TI, CE, RC, PS, NU, AI, MI, CD, NI."
}

{
    "traceId": "916455edb2abace0",
    "timestamp": "2026-10-11 11:49:27",
    "code": "IDV-PRO02",
    "message": "Bad request: document number is invalid. Check the format and length for the document type."
}

Response 401 status code

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

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

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