Financial Info

Description

The Colombia Financial Info service consults the Registro Universal de Ingresos (RUI), the official income classification of the Colombian government published by the Departamento Nacional de Planeación (DNP).

The service uses the individual's identity document number as the primary identifier, since that document number is the key required to retrieve the income group and RUI level.

HTTP method GET

Endpoint

https://api.msla-id.com/experience-idv-financial-api-v1/api/idv-govcheck/v1/co-identity/{documentNumber}/financial-info

[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, check the login documentation.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

Path request parameter

NAME	REQUIRED	TYPE	DESCRIPTION	EXAMPLE
documentNumber	✅	string	Colombia identity document, 6 to 11 digits	1234567890

Status code responses

Code	Description
200	OK
400	Bad request
401	Unauthorized
403	Forbidden — IDV-1004
404	Not found — IDV-1002 Data not found.
500	Internal server error.
504	Gateway timeout — IDV-1100

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "34372f63ac42d547",
    "timestamp": "2026-08-14 15:26:08",
    "data": {
        "documentNumber": "1234567890",
        "country": "CO",
        "fullName": "ALICIA PEREZ GUZMAN",
        "nameType": "3",
        "incomeGroup": "Solo ingreso estimado",
        "ruiGroup": "C",
        "ruiLevel": "C01",
        "municipality": "CALIFORNIA",
        "department": "SANTANDER",
        "municipalityCode": "68132",
        "sex": "Femenino",
        "age": "74"
    }
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-3001",
    "message": "Bad request - Invalid or incomplete input data",
    "data": null
}

Response 401 status code

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

Response 403 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1004",
    "message": "Access denied"
}

Response 404 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1002",
    "message": "Data not found."
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1008",
    "message": "Error in the source of origin, please contact an administration.",
    "data": null
}

Response 504 status code

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