Endpoint: Registro Universal de Ingresos (RUI)

Devuelve el grupo de una persona en el Registro Universal de Ingresos, la escala que reemplazó al Sisbén como criterio de focalización, con su nivel y su grupo de ingresos. Es el mismo endpoint que /api/sisben con otro nombre: la Ventanilla Social entrega las dos escalas juntas y aquí se devuelven las dos, así que da igual cuál se llame. Existe porque quien busca por RUI no busca por Sisbén. Se documenta aparte de /api/sisben porque son dos preguntas distintas sobre la misma respuesta. El Sisbén IV clasifica por condiciones de vida en cuatro grupos con subgrupo; el RUI clasifica por ingresos y es el criterio con el que hoy se focalizan los programas. Quien viene con una regla escrita en términos de RUI no puede traducirla a grupos del Sisbén, y al revés tampoco: por eso la respuesta trae las dos escalas y cada una tiene su página.

POST/api/rui1 crédito

Grupo del **Registro Universal de Ingresos (RUI)** de una persona por documento, de la Ventanilla Social del DNP: el nivel y el grupo de ingresos con los que hoy se decide el acceso a programas sociales. **Es el mismo endpoint que `/api/sisben`** y devuelve el mismo objeto —la fuente entrega las dos escalas juntas y aquí se entregan las dos—, así que da igual cuál se llame; existe con nombre propio porque el RUI reemplazó al Sisbén como criterio de focalización y quien trae una regla escrita en grupos del RUI no puede traducirla a grupos del Sisbén. Junto al RUI vienen el grupo del **Sisbén IV** y los datos básicos de la persona; el detalle de esa escala está en `/api/sisben`. **Una persona no registrada responde 404 y NO cobra.** ⚠️ La existencia del documento la decide el registro de ingresos y no el grupo del Sisbén: el endpoint oficial de ese grupo le asigna "D4 – no pobre, no vulnerable" a documentos que **no existen**, así que aquí un `sisben: null` significa "la persona existe y no tiene grupo publicado", nunca un dato inventado. Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)
{
  "docType": "CC",
  "docNumber": "1020304050"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
docTypeobligatoriostringTipo de documento. Es un registro de PERSONAS naturales: con NIT o carné diplomático responde 400 `tipo_documento_no_soportado` sin cobrar.Valores: CC · CE · TI · RC · PA · PPT · PEP
docNumberobligatoriostringNúmero de documento. Alias aceptado: `doc`.
refreshbooleanIgnora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).

Ejemplos por lenguaje

cURL
curl -X POST 'https://placapi.com/api/rui' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"docType":"CC","docNumber":"1020304050"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/rui", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"docType":"CC","docNumber":"1020304050"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/rui",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"docType":"CC","docNumber":"1020304050"},
)
data = res.json()

Respuesta exitosa

200 OK — datos ficticios de ejemplo
{
  "source": "clasificacion-social",
  "status": "info",
  "data": {
    "documento": "1020304050",
    "tipoDocumento": "CC",
    "persona": {
      "nombre": "JUAN CARLOS PEREZ GOMEZ",
      "sexo": "Masculino",
      "edad": 38
    },
    "ubicacion": {
      "departamento": "VALLE DEL CAUCA",
      "municipio": "CALI",
      "codigoMunicipio": "76001"
    },
    "sisben": {
      "grupo": "B",
      "nivel": "B6",
      "descripcion": "Pobreza moderada"
    },
    "rui": {
      "tieneClasificacion": true,
      "grupo": "C",
      "nivel": "C15",
      "grupoIngresos": "Ingreso observado y estimado"
    }
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z",
  "cost": 1
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

Última revisión: 23 de agosto de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto