DNP (Sisbén IV e RUI)

O Departamento Nacional de Planeación (DNP) administra o Sisbén IV, a pesquisa que classifica os domicílios colombianos de A1 (pobreza extrema) a D21 para os programas sociais, e o Registro Universal de Ingresos (RUI), a classificação por renda que o sucede. Ambos se apoiam no Registro Social de Hogares, o registro do DNP com mais de 55 milhões de pessoas. Envie um documento e receba as duas classificações, ou encontre o escritório do Sisbén que atende um município.

Classificação socioeconômica

POST /co/dnp/social-classification/v1 Retorna o grupo do Sisbén IV e a classificação RUI de uma pessoa.

Campo	Tipo	Notas
`document_type`	enum	Tipo de documento colombiano (`CC`, `TI`, `CE`, `RC`, `PA`, `PEP`, `PPT`). Por padrão `CC`.
`document_number`	string	Obrigatório. Entre 3 e 30 caracteres.

curl https://api.croma.run/co/dnp/social-classification/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_type": "CC", "document_number": "1234567890" }'

Campo	Notas
`found`	`true` quando a pessoa tem grupo do Sisbén IV, classificação RUI ou ambos. `false` é um `200` normal, não um `404`; nesse caso `sisben` e `rui` são `null`.
`sisben`	`{ group, category, label, municipality, department }`, ou `null`. `group` vai de `A1` a `D21`; `label` é o texto do próprio registro, p. ex. `Vulnerable`; `municipality` e `department` são onde a pessoa foi recenseada.
`rui`	`{ classification, category, income_group, full_name, sex, age, municipality, department }`, ou `null` quando a pessoa não tem classificação RUI.

category é a letra que as duas classificações compartilham:

`category`	Significado
`A`	Pobreza extrema
`B`	Pobreza moderada
`C`	Vulnerável
`D`	Nem pobre, nem vulnerável

O RUI (Registro Universal de Ingresos) classifica as pessoas pela renda estimada e sucede o Sisbén IV como instrumento de focalização dos programas sociais a partir do segundo semestre de 2026 (Decreto 875 de 2024). Uma pessoa pode ter um sem o outro, então leia os dois.

Escritórios do Sisbén

POST /co/dnp/sisben-offices/v1 Retorna quem administra o Sisbén em um departamento ou município, e como contatá-lo.

Campo	Tipo	Notas
`department_code`	enum	Opcional. O código DIVIPOLA de dois dígitos do departamento, p. ex. `05` (Antioquia) ou `11` (Bogotá). Omita-o para listar todos os coordenadores departamentais.

curl https://api.croma.run/co/dnp/sisben-offices/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "department_code": "05" }'

Retorna department_code, total e offices[]. Sem department_code, offices lista o coordenador do Sisbén de cada departamento. Com ele, o coordenador desse departamento seguido do administrador do Sisbén de cada um de seus municípios. Cada elemento de offices[] é { level, department, department_code, municipality, municipality_code, contact_name, address, phone, email }. level é departmental ou municipal; os códigos são DIVIPOLA (05, 05002); phone vem como publicado, às vezes com vários números ou um ramal.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.

Primeiros passos

Tipos de solicitação

Países

DNP (Sisbén IV e RUI)

Classificação socioeconômica

Escritórios do Sisbén

Referência completa

​Classificação socioeconômica

​Escritórios do Sisbén

Referência completa

Classificação socioeconômica

Escritórios do Sisbén