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.

¿Cuál endpoint usar?

	GET /v3/co/rues (este API)	GET /v3/co/rues-complete
Uso	Resumen rápido por categoría de registro	Expediente completo
Datos típicos	Campos principales de la categoría	Representantes, actividades económicas, establecimientos, etc.
Parámetros	documentType (NIT), documentNumber, category opcional	Los mismos
Precio en catálogo	Menor (ej. 0,2 créditos / 0,3 SmartCheck)	Mayor (ej. 0,3 créditos / 0,4 SmartCheck)

Ver Colombia — RUES expediente completo (v3).

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

• Este endpoint devuelve un resumen, no el expediente completo. Para representantes, actividades y establecimientos, usa GET /v3/co/rues-complete (RUES expediente completo (v3)).
• /v2/co/rues es legado; nuevas integraciones en v3.
• category es opcional (por defecto RM); indícala cuando no consultes Registro Mercantil.