Registro Único Empresarial y Social - RUES

Description

The Only Business and Social - RUES is the great business information center in Colombia which provides the State, society in general, businessmen, contractors, solidarity economy entities and non-profit entities a reliable unified information tool both nationally and internationally.

HTTP method GET

https://api.msla-id.com/experience-idv-taxes-api-v1/api/idv-govcheck/v1/co-identity/{documentNumber}/rues-check

[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	Tax Identification Number (NIT) of the company to be queried.

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": "0cca4ee3a33d5d0c",
    "timestamp": "2026-10-12 16:55:39",
    "data": {
        "chamberCode": "01",
        "chamberCommerce": "ARMENIA",
        "registrationNumber": "12345",
        "proponentRegistration": "000000000000",
        "businessName": "LUIS JOSE FRANCISCO JOSE",
        "firstLastName": "LUIS",
        "secondLastName": "JOSE",
        "firstName": "GONZALES",
        "middleName": "JOSE",
        "acronym": "SIN INFORMACION",
        "idTypeCode": "01",
        "idType": "CEDULA DE CIUDADANIA",
        "idNumber": "1234567",
        "nit": "12345670",
        "verificationDigit": "SIN INFORMACION",
        "primaryCiiuCode": "9999",
        "primaryCiiu": "SIN INFORMACION",
        "registrationDate": "1986-09-15",
        "renewalDate": "2011-02-14",
        "lastRenewalYear": "2011",
        "validityDate": "9999-12-31",
        "cancellationDate": "2011-05-14",
        "companyTypeCode": "02",
        "companyType": "SOCIEDAD COMERCIAL",
        "legalOrgCode": "01",
        "legalOrg": "PERSONA NATURAL",
        "registrationCategoryCode": "00",
        "registrationCategory": "PERSONA NATURAL",
        "registrationStatusCode": "03",
        "registrationStatus": "CANCELADA",
        "legalRepIdType": "SIN INFORMACION",
        "legalRepIdNumber": "SIN INFORMACION",
        "legalRepName": "SIN INFORMACION",
        "updateDate": "2020-11-13T02:13:01.290"
    }
}

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
}

Response 401 status code

{
    "traceId": "0829a4407237096a",
    "timestamp": "2024-06-25 09:02:15",
    "code": "IDV-1002"
}

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": "86c6eda02b615604",
  "timestamp": "2024-01-09 15:44:32",
  "code": "IDV-1008",
  "message": "Error in the source of origin, please contact an administrator!",
  "data": null
}

Response 504 status code

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