🇨🇴Complete Business Registry - RUES

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

Complete Business Registry - RUES

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

The Business Information Service allows you to retrieve detailed information about a business registered in Colombia using its NIT (Número de Identificación Tributaria). This service provides comprehensive details including commercial registry information, legal representatives, and the economic activities associated with the business.

It's a valuable tool for verifying business credentials, understanding business operations, and conducting due diligence.

Implementation

Headers

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

Body

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/complete>',
  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/complete?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/complete?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/complete?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": {
        "commercialRegistry": {
            "NIT": "860002964-4",
            "acronym": "",
            "businessName": "BANCO DE BOGOTA",
            "chamberCommerce": "BOGOTA",
            "commercialAddress": "CL 36 # 7 47 P 15",
            "companyLocation": "",
            "companyType": "SOCIEDAD ANONIMA",
            "email": "[e-mail]",
            "enrollmentCategory": "8/27/2024 1:30:04 PM",
            "enrollmentDate": "19841012",
            "idRm": "40000221830",
            "lastRenewedYear": "2024",
            "lastUpdatedDate": "8/27/2024 1:30:04 PM",
            "legalRepresentatives": {
                "faculty": "Información no disponible",
                "legalRepresentatives": [
                    [
                        {
                            "role": "Representante Legal",
                            "name": "John Freddy Vega Forero",
                            "documentType": "CC",
                            "documentNumber": "1019005801"
                        }
                    ]
                ]
            },
            "organizationType": "SOCIEDAD ó PERSONA JURIDICA PRINCIPAL ó ESAL",
            "reasonForCancellation": "SOCIEDAD COMERCIAL",
            "registrationNumber": "221830",
            "registrationStatus": "ACTIVA",
            "renewalDate": "20240322"
        },
        "documentNumber": "860002964",
        "documentType": "NIT",
        "economicActivities": [
            {
                "name": "ciiu_act_econ_pri",
                "code": "6412",
                "description": "Bancos comerciales"
            },
            {
                "name": "ciiu_act_econ_sec",
                "code": "",
                "description": ""
            },
            {
                "name": "ciiu3",
                "code": "",
                "description": ""
            },
            {
                "name": "ciiu4",
                "code": "",
                "description": ""
            }
        ]
    },
    "signature": {
        "dateTime": "August 27, 2024 9:44 PM",
        "message": "Certified by Verifik.co"
    },
    "id": "DQHPI"
}

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