🇨🇴Colombian Business Information - RUES

Service to query Colombian companies against the RUES (Single Business and Social Registry) using the NIT (Tax Identification Number).

Create a new user

GET - https://api.verifik.co/v2/co/rues

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).

Implementation

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Query 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

Name	Type	Description
name	string	Name of the user
age	number	Age of the user

Request

JavaScript

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);
}

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {}
conn.request("GET", "/v2/co/rues?documentType=NIT&documentNumber=", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/co/rues?documentType=NIT&documentNumber=")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/co/rues?documentType=NIT&documentNumber=');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setBody('');
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Response

200

{
  "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"
}

404

{
"code": "NotFound",
"message": "No existe contribuyente asociado a la NIT ingresada",
"signature": {
"dateTime": "February 21, 2024 7:52 PM",
"message": "Certified by Verifik.co"
}
}

409

{
"code": "MissingParameter",
"message": "missing documentType\n. missing documentNumber\n"
}

409

{
"code": "MissingParameter",
"message": "documentType must be one of: [NIT]"
}