> ## 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 y RUI)

> La clasificación socioeconómica de una persona en Colombia por documento: su grupo de Sisbén IV y su clasificación de ingresos del RUI, desde el DNP, más el directorio de oficinas del Sisbén.

El Departamento Nacional de Planeación (DNP) administra el Sisbén IV, la
encuesta que clasifica a los hogares colombianos de `A1` (pobreza extrema) a
`D21` para la oferta social, y el Registro Universal de Ingresos (RUI), la
clasificación por ingresos que lo sucede. Ambos se apoyan en el Registro Social
de Hogares, el registro del DNP de más de 55 millones de personas.

Envía un documento y obtén ambas clasificaciones, o encuentra la oficina del
Sisbén que atiende un municipio.

## Clasificación socioeconómica

`POST /co/dnp/social-classification/v1` Devuelve el grupo de Sisbén IV y la clasificación RUI de una persona.

| Campo             | Tipo   | Notas                                                                                        |
| ----------------- | ------ | -------------------------------------------------------------------------------------------- |
| `document_type`   | enum   | Tipo de documento colombiano (`CC`, `TI`, `CE`, `RC`, `PA`, `PEP`, `PPT`). Por defecto `CC`. |
| `document_number` | string | **Obligatorio.** Entre 3 y 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` cuando la persona tiene grupo de Sisbén IV, clasificación RUI o ambos. `false` es un `200` normal, no un `404`; en ese caso `sisben` y `rui` son `null`.                                                               |
| `sisben` | `{ group, category, label, municipality, department }`, o `null`. `group` va de `A1` a `D21`; `label` es el texto del propio registro, p. ej. `Vulnerable`; `municipality` y `department` son donde se encuestó a la persona. |
| `rui`    | `{ classification, category, income_group, full_name, sex, age, municipality, department }`, o `null` cuando la persona no tiene clasificación RUI.                                                                           |

`category` es la letra que comparten ambas clasificaciones:

| `category` | Significado             |
| ---------- | ----------------------- |
| `A`        | Pobreza extrema         |
| `B`        | Pobreza moderada        |
| `C`        | Vulnerable              |
| `D`        | No pobre, no vulnerable |

<Note>
  El RUI (Registro Universal de Ingresos) clasifica a las personas por su
  ingreso estimado y sucede al Sisbén IV como instrumento de focalización de la
  oferta social desde el segundo semestre de 2026 (Decreto 875 de 2024). Una
  persona puede tener uno sin el otro, así que lee ambos.
</Note>

## Oficinas del Sisbén

`POST /co/dnp/sisben-offices/v1` Devuelve quién administra el Sisbén en un departamento o municipio, y cómo contactarlo.

| Campo             | Tipo | Notas                                                                                                                                                                 |
| ----------------- | ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `department_code` | enum | Opcional. El código DIVIPOLA de dos dígitos del departamento, p. ej. `05` (Antioquia) o `11` (Bogotá). Omítelo para listar a todos los coordinadores departamentales. |

```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" }'
```

Devuelve `department_code`, `total` y `offices[]`. Sin `department_code`, `offices` lista al coordinador del Sisbén de cada departamento. Con él, el coordinador de ese departamento seguido del administrador del Sisbén de cada uno de sus municipios.

Cada elemento de `offices[]` es `{ level, department, department_code, municipality, municipality_code, contact_name, address, phone, email }`. `level` es `departmental` o `municipal`; los códigos son DIVIPOLA (`05`, `05002`); `phone` va tal como se publica, a veces con varios números o una extensión.

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>