The Colombian Business Information service - RUES (Registro Único Empresarial y Social) offers detailed information about businesses registered in Colombia. By using this service, you can obtain essential details about a specific business, including its name, registration number, document type, identification details, location (municipality), registration category, and its status in the Registro Mercantil (RM, Mercantile Register).

Parameters

Name Type ¿Required? Description Example
documentType String True Valid parameter: NIT NIT
documentNumber String True NIT of the company, without spaces, points and without verification number. 901331380

Implementation

Request

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/co/rues>',
  params: {documentNumber: '901331380', documentType: 'NIT'},
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  }
};

try {
 notFou const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Response 200 - (Successful response)

{
  "data": {
    "businessName": "VERIFIK SAS",
    "documentNumber": "901331380",
    "documentType": "NIT",
    "identification": "NIT 901331380 - 2",
    "municipality": "BOGOTA, D.C. / BOGOTA",
    "registration_category": "SOCIEDAD ó PERSONA JURIDICA PRINCIPAL ó ESAL",
    "statusRM": "CANCELADA"
  },
  "signature": {
    "dateTime": "September 21, 2023 9:09 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "nss88"
}

Other responses

Code Description Response Body
404 Not Found Information not found.

| { "code": "NotFound", "message": "No existe contribuyente asociado a la CUIT ingresada", "signature": { "dateTime": "February 21, 2024 7:52 PM", "message": "Certified by Verifik.co" } } | | 409 | Conflict | Some parameters are missing. | { "code": "MissingParameter", "message": "missing documentType\n. missing documentNumber\n" } | | 409 | Conflict | Invalid documentType for this query. | { "code": "MissingParameter", "message": "documentType must be one of: [NIT]" } |