Colombia — RUI Classification

Verifik queries the Registro Universal de Ingresos (RUI) via DNP Ventanilla Social using documentType and documentNumber.

Replaces SISBEN

This product replaces the retired SISBEN lookup (GET /v2/co/sisben). Use GET /v2/co/rui for current income-group classification from Ventanilla Social.

What this API returns

• grupoIngresos — income-group description when returned by the source
• grupRui / nivelRui — RUI group letter and classification level (for example A / A01)
• Location — municipio, departamento, codMpio
• Person fields — nombre, sexo, edad when present
• Document identifiers (documentType, documentNumber) and a signed Verifik response

API reference

Endpoint

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

This endpoint is GET-only (query parameters). POST is also accepted with the same body fields.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parameters

name	type	required	description
documentType	string	yes	One of CC, CE, TI, PPT, PEP, RC.
documentNumber	string	yes	Document number without spaces or punctuation (5–15 characters).

Request

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

Response

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

Notes

• Sandbox: use document numbers 10000001–10000010 (and standard sandbox error fixtures) to exercise classification responses without calling the live source.
• Treat responses as sensitive personal data; comply with Colombian privacy rules.
• Field presence can vary by source availability; always handle nulls for optional person/location fields.