---
title: "DANE Poverty"
method: POST
path: "/co/dane/poverty/v1"
tags: ["Colombia", "DANE"]
---

# DANE Poverty

`POST /co/dane/poverty/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/dane/poverty/v1`
- Auth: HTTP bearer

Colombia's poverty and inequality from DANE: monetary and extreme poverty (incidence and people), Gini coefficient, income per capita and poverty lines for the nation, 23 departments and Bogotá since 2021; and multidimensional poverty (IPM) for the nation and its regions since 2010 and for all 33 departments since 2018, by total, cabeceras and rural. Filter by DIVIPOLA code, territory level, indicator, domain and years. Served by Croma (`as_of` says how current the data is).

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `territory_code` string: Optional DIVIPOLA code: 2 digits for a department (`44`), 5 for a municipality (`44001`).
  - `territory_level` '' | 'national' | 'region' | 'department' | 'metropolitan_area' | 'city' | 'city_aggregate': Optional kind of territory: `national`, `region`, `department`, `metropolitan_area`, `city` or `city_aggregate` (a group of cities, e.g. the 13 main cities).
  - `indicator_code` '' | 'monetary_poverty_rate' | 'monetary_poverty_persons' | 'extreme_poverty_rate' | 'extreme_poverty_persons' | 'gini' | 'income_per_capita' | 'poverty_line' | 'extreme_poverty_line' | 'multidimensional_poverty_rate': Optional indicator, e.g. `monetary_poverty_rate`, `extreme_poverty_rate`, `multidimensional_poverty_rate` (IPM), `gini`. Empty returns every indicator.
  - `domain` '' | 'total' | 'urban' | 'rural': Optional domain: `total`, `urban` (cabeceras) or `rural` (centros poblados y rural disperso).
  - `year_from` integer: Optional first year (inclusive). 0 sets no lower bound.
  - `year_to` integer: Optional last year (inclusive). 0 sets no upper bound.
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Results per page (1-500).

## Response `200`

Successful response

- DanePovertyResponse
  - `data` DanePovertyData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `territory_code` string, nullable, required
    - `territory_level` string, nullable, required
    - `indicator_code` string, nullable, required
    - `domain` string, nullable, required
    - `year_from` number, nullable, required
    - `year_to` number, nullable, required
    - `total` number, required: Matches, counted up to 1000.
    - `total_is_exact` boolean, required: False when more than 1000 match.
    - `page` number, required
    - `per_page` number, required
    - `total_pages` number, required
    - `count` number, required
    - `results` object[], required
      - `series_id` string, required: The observation: territory, domain, indicator and year, e.g. "44:total:multidimensional_poverty_rate:2025".
      - `territory_code` string, nullable, required: DIVIPOLA code: 2 digits for a department, 5 for a municipality. A metropolitan area carries its core municipality's code. Null for the national total, regions and groups of cities.
      - `territory_name` string, required: The territory as DANE names it, e.g. "Bogotá D.C.", "Medellín A.M.", "La Guajira", "Caribe".
      - `territory_level` 'national' | 'region' | 'department' | 'metropolitan_area' | 'city' | 'city_aggregate', required: `national`, `region`, `department`, `metropolitan_area`, `city` or `city_aggregate`.
      - `domain` 'total' | 'urban' | 'rural', required: `total`, `urban` (cabeceras) or `rural` (centros poblados y rural disperso).
      - `indicator_code` string, required: The indicator, e.g. `monetary_poverty_rate`, `extreme_poverty_rate`, `multidimensional_poverty_rate`, `gini`.
      - `indicator` string, required: The indicator as DANE names it, e.g. "Incidencia de la pobreza monetaria".
      - `unit` 'percent' | 'thousands_of_people' | 'cop_per_month' | 'coefficient', required: `percent`, `thousands_of_people`, `cop_per_month` (current pesos per person per month) or `coefficient` (Gini, 0 to 1).
      - `year` number, required: The year the value measures.
      - `value` number, required: The value as DANE published it.
      - `release` string, required: The annual release this value was read from, e.g. "2025".
      - `document_url` string, nullable, required: The DANE workbook this value comes from, exactly as DANE published it, always available at this link.
      - `source_document_url` string, nullable, required: The same workbook's link at DANE.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)