Colombia — Clasificación RUI

Verifik consulta el Registro Universal de Ingresos (RUI) en Ventanilla Social DNP usando documentType y documentNumber.

Reemplaza SISBEN

Este producto reemplaza la consulta SISBEN retirada (GET /v2/co/sisben). Use GET /v2/co/rui para la clasificación actual de grupo de ingresos en Ventanilla Social.

Qué retorna esta API

• grupoIngresos — descripción del grupo de ingresos cuando la fuente la entrega
• grupRui / nivelRui — letra de grupo y nivel RUI (por ejemplo A / A01)
• Ubicación — municipio, departamento, codMpio
• Datos de la persona — nombre, sexo, edad cuando existen
• Identificadores del documento (documentType, documentNumber) y una respuesta firmada de Verifik

Referencia de la API

Endpoint

GET https://api.verifik.co/v2/co/rui

Este endpoint es solo GET (parámetros de consulta). También se acepta POST con los mismos campos en el body.

Encabezados

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parámetros

name	type	required	description
documentType	string	sí	Uno de CC, CE, TI, PPT, PEP, RC.
documentNumber	string	sí	Número de documento sin espacios ni puntuación (5–15 caracteres).

Solicitud

JavaScript

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/rui", {
	params: {
		documentType: "CC",
		documentNumber: "10000001",
	},
	headers: {
		Accept: "application/json",
		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
	},
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/rui"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CC", "documentNumber": "10000001"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Respuesta

200

{
	"data": {
		"codMpio": "11001",
		"departamento": "BOGOTA D.C.",
		"documentNumber": "10000001",
		"documentType": "CC",
		"edad": "26",
		"grupRui": "A",
		"grupoIngresos": "Solo ingreso estimado",
		"municipio": "BOGOTA",
		"nivelRui": "A01",
		"nombre": "MARIA ELENA LOPEZ GARCIA",
		"sexo": "Femenino"
	},
	"signature": {
		"dateTime": "August 10, 2026 8:00 PM",
		"message": "Certified by Verifik.co"
	}
}

404

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

409

{
	"code": "MissingParameter",
	"message": "documentType must be one of [CC, CE, TI, PPT, PEP, RC]"
}

Notas

• Sandbox: use los números de documento 10000001–10000010 (y los fixtures de error estándar del sandbox) para probar clasificaciones sin llamar a la fuente en vivo.
• Trate las respuestas como datos personales sensibles; cumpla las normas de privacidad de Colombia.
• La presencia de campos puede variar según la fuente; maneje siempre valores nulos en campos opcionales.