UBO - Colombia

Description

Access UBO and KYB data in Colombia through the RUES (Registro Único Empresarial y Social). This service retrieves legal representatives, branch offices, and incorporation history to ensure compliance.

HTTP method POST

Endpoint

https://apidev.msla-id.com/experience-company-ubos-api-v1/api/idv-govcheck/v1/col-identity/ubo/company

info

This endpoint requires Bearer Token authentication. Contact IT support to get credentials.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Content-Type	✅	string	application/json
Authorization	✅	string	Bearer JWT token

Request body parameters

NAME	REQUIRED	TYPE	DESCRIPTION
NIT	✅	string	Company Tax ID number

Request example

{
    "nit": "900123456"
}

Status code responses

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

Response 200 status code

{
    "traceId": "c4bb89c52f664757",
    "timestamp": "2026-03-24 16:54:54",
    "data": {
        "nit": "890919414",
        "legalRepresentatives": [
            {
                "document": "890919414",
                "name": "MOLINA GAVIRIA MAURICIO",
                "role": "REPRESENTANTE LEGAL"
            }
        ],
        "branches": [
            {
                "registeredName": "INDUSTRIAS EMU S.A.S.",
                "chamberOfCommerce": "BARRANQUILLA",
                "registrationNumber": null,
                "status": "ACTIVA",
                "category": "SUCURSAL",
                "incorporationDate": "2002-01-25",
                "lastRenewal": null
            },
            {
                "registeredName": "INDUSTRIAS EMU S.A.S.",
                "chamberOfCommerce": "ABURRA SUR",
                "registrationNumber": null,
                "status": "ACTIVA",
                "category": "ESTABLECIMIENTO DE COMERCIO",
                "incorporationDate": "2002-01-25",
                "lastRenewal": null
            },
            {
                "registeredName": "INDUSTRIAS EMU S.A.S.",
                "chamberOfCommerce": "BOGOTA",
                "registrationNumber": null,
                "status": "ACTIVA",
                "category": "ESTABLECIMIENTO DE COMERCIO",
                "incorporationDate": "2002-01-25",
                "lastRenewal": null
            }
        ],
        "queryTimestamp": "2026-03-24T16:54:54.135653",
        "source": "RUES - Registro Único Empresarial y Social"
    }
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2025-03-16 11:20:46",
    "code": "IDV-4005",
    "message": "Bad request - Invalid parameters provided",
    "data": null
}

Response 400: The RUT must not be null or empty

{
    "traceId": "0ecbc8208e29cedc",
    "timestamp": "2026-03-24 17:02:39",
    "code": "IDV-4001",
    "message": "Invalid request. The RUT must not be null or empty.",
    "data": null
}

Response 400: Data not found.

{
    "traceId": "0797fcbbc031b554",
    "timestamp": "2026-03-24 17:04:28",
    "code": "IDV-1002",
    "message": "Data not found.",
    "data": null
}

Response 401 status code

{
    "timestamp": "2025-03-16T11:20:46.000Z",
    "status": 401,
    "error": "Unauthorized",
    "message": "Bearer token is missing or invalid",
    "path": "/api/ubos"
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "2025-03-16 11:20:46",
    "code": "IDV-1001",
    "message": "A generic error has occurred.",
    "data": null
}