Colombia — Consulta RUES (v3)

Verifik consulta RUES (Registro Único Empresarial y Social) con NIT, categoría de registro y devuelve un resumen normalizado para esa línea. Es el endpoint básico /v3/co/rues; para el expediente completo usa /v3/co/rues-complete.

Referencia de API

Endpoint

GET https://api.verifik.co/v3/co/rues

GET por query: documentType=NIT, documentNumber, category opcional (por defecto RM). Para expediente completo, usar GET /v3/co/rues-complete.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parámetros

name	type	required	description
documentType	string	sí	Debe ser NIT.
documentNumber	string	sí	Número de identificación tributaria (el servidor elimina signos).
category	string	no	RM, PROP, RUNEOL, RNT, ESAL, ESOL, JUEGOS, EXTRANJERAS. Por defecto RM.

Solicitud

JavaScript

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v3/co/rues", {
	params: {
		documentType: "NIT",
		documentNumber: "800096561",
		category: "RM",
	},
	headers: {
		Accept: "application/json",
		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
	},
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v3/co/rues"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "NIT", "documentNumber": "800096561", "category": "RM"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Respuesta

200

{
	"data": {
		"businessName": "EJEMPLO SAS",
		"documentNumber": "800096561",
		"documentType": "NIT",
		"fullNit": "800096561-7",
		"location": "…",
		"organizationType": "…",
		"status": "ACTIVA",
		"category": "RM",
		"registration": "…",
		"chamberCode": "…"
	},
	"signature": {
		"dateTime": "January 16, 2024 3:44 PM",
		"message": "Certified by Verifik.co"
	}
}

404

{
	"code": "NotFound",
	"message": "Record not found."
}

409

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

Casos de uso

• Verificación KYB rápida
• Comprobar existencia en RUES antes de un rues-complete

Notas

• Para datos completos (representantes, actividades, etc.) usa /v3/co/rues-complete.
• /v2/co/rues es legado; nuevas integraciones en v3.