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

> A person's socioeconomic classification in Colombia by document: their Sisbén IV group and their RUI income classification, from the DNP, plus the directory of Sisbén offices.

The Departamento Nacional de Planeación (DNP) runs Sisbén IV, the survey that
classifies Colombian households from `A1` (extreme poverty) to `D21` for social
programmes, and the Registro Universal de Ingresos (RUI), the income-based
classification that succeeds it. Both sit on the Registro Social de Hogares,
the DNP's register of more than 55 million people.

Send a document and get both classifications, or find the Sisbén office that
serves a municipality.

## Social classification

`POST /co/dnp/social-classification/v1` Returns a person's Sisbén IV group and RUI classification.

| Field             | Type   | Notes                                                                               |
| ----------------- | ------ | ----------------------------------------------------------------------------------- |
| `document_type`   | enum   | Colombian document type (`CC`, `TI`, `CE`, `RC`, `PA`, `PEP`, `PPT`). Default `CC`. |
| `document_number` | string | **Required.** 3-30 chars.                                                           |

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

| Field    | Notes                                                                                                                                                                                                                            |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `found`  | `true` when the person has a Sisbén IV group, a RUI classification, or both. `false` is a normal `200`, not a `404`; `sisben` and `rui` are then `null`.                                                                         |
| `sisben` | `{ group, category, label, municipality, department }`, or `null`. `group` runs from `A1` to `D21`; `label` is the register's own wording, e.g. `Vulnerable`; `municipality` and `department` are where the person was surveyed. |
| `rui`    | `{ classification, category, income_group, full_name, sex, age, municipality, department }`, or `null` when the person has no RUI classification.                                                                                |

`category` is the letter both classifications share:

| `category` | Meaning                     |
| ---------- | --------------------------- |
| `A`        | Extreme poverty             |
| `B`        | Moderate poverty            |
| `C`        | Vulnerable                  |
| `D`        | Neither poor nor vulnerable |

<Note>
  The RUI (Registro Universal de Ingresos) classifies people by estimated
  income and succeeds Sisbén IV as the targeting instrument for social
  programmes from the second half of 2026 (Decreto 875 de 2024). A person can
  have one without the other, so read both.
</Note>

## Sisbén offices

`POST /co/dnp/sisben-offices/v1` Returns who runs the Sisbén in a department or municipality, and how to reach them.

| Field             | Type | Notes                                                                                                                                       |
| ----------------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `department_code` | enum | Optional. The department's two-digit DIVIPOLA code, e.g. `05` (Antioquia) or `11` (Bogotá). Omit it to list every departmental coordinator. |

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

Returns `department_code`, `total` and `offices[]`. Without `department_code`, `offices` lists every department's Sisbén coordinator. With it, that department's coordinator followed by the Sisbén administrator of each of its municipalities.

Each `offices[]` entry is `{ level, department, department_code, municipality, municipality_code, contact_name, address, phone, email }`. `level` is `departmental` or `municipal`; codes are DIVIPOLA (`05`, `05002`); `phone` is as published, sometimes several numbers or an extension.

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, all response fields, and an interactive playground.
</Card>