> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DNP (Sisbén IV e RUI)

> A classificação socioeconômica de uma pessoa na Colômbia por documento: seu grupo do Sisbén IV e sua classificação de renda do RUI, a partir do DNP, mais o diretório de escritórios do Sisbén.

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.                                                   |

```bash theme={"dark"}
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 |

<Note>
  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.
</Note>

## 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. |

```bash theme={"dark"}
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.

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>