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

# DANE

> Las estadísticas oficiales de Colombia del DANE: series de mercado laboral para la nación y 32 ciudades, pobreza monetaria y multidimensional por departamento, y el censo de 2018 y la pobreza multidimensional de cada municipio, por código DIVIPOLA.

Las estadísticas oficiales del Departamento Administrativo Nacional de
Estadística (DANE): el mercado laboral de la Gran Encuesta Integrada de Hogares
(GEIH), la pobreza monetaria y multidimensional, y el Censo Nacional de
Población y Vivienda de 2018, con cada territorio identificado por su código
DIVIPOLA para cruzar las series con cualquier otra fuente por departamento o
municipio.

Cada serie está organizada y lista para consultar: la tasa de desocupación de
una ciudad durante veinte años, la pobreza multidimensional de cada
departamento o la distribución por estrato de las viviendas de un municipio,
cada una en una sola llamada rápida.

<Note>
  La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
</Note>

## Mercado laboral

`POST /co/dane/labour-market/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

Las series de mercado laboral, filtradas por cualquier combinación de
territorio, indicador, tipo de periodo, dominio y fechas. El periodo más
reciente primero.

| Campo | Tipo | Notas |
| - | - | - |
| `territory_code` | string | Código DIVIPOLA opcional: 2 dígitos para un departamento (`44`), 5 para un municipio (`44001`). Un área metropolitana responde al código de su municipio núcleo. |
| `territory_level` | enum | Opcional: `national`, `region`, `department`, `metropolitan_area`, `city` o `city_aggregate` (un grupo de ciudades, p. ej. las 13 principales). |
| `indicator_code` | enum | Opcional: `unemployment_rate` (TD), `employment_rate` (TO), `participation_rate` (TGP), `underemployment_rate` (TS), `working_age_share`, las tasas combinadas de subutilización, o una población en miles (`population`, `labour_force`, `employed`, `unemployed`, ...). |
| `period_type` | enum | Opcional: `monthly` (la nación y las 13 ciudades principales), `rolling_quarter` (trimestre móvil, 23 ciudades y áreas metropolitanas) o `rolling_year` (año móvil, 32 ciudades). Un periodo móvil se fecha por su último mes. |
| `domain` | enum | Opcional: `total` o `urban` (cabeceras, solo nacional). |
| `from_date` | string | Opcional. Primer mes (`yyyy-mm-dd`, cuenta el mes en que cae). |
| `to_date` | string | Opcional. Último mes (`yyyy-mm-dd`, inclusive). |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Por defecto `100`. |

```bash theme={"dark"}
curl https://api.croma.run/co/dane/labour-market/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "indicator_code": "unemployment_rate",
        "territory_level": "national",
        "period_type": "monthly",
        "domain": "total",
        "from_date": "2025-01-01"
      }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`.

## Pobreza

`POST /co/dane/poverty/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

La pobreza monetaria y multidimensional, filtrada por territorio, indicador,
dominio y años. El año más reciente primero.

| Campo | Tipo | Notas |
| - | - | - |
| `territory_code` | string | Código DIVIPOLA opcional de 2 dígitos de un departamento, p. ej. `44` (La Guajira). |
| `territory_level` | enum | Opcional: `national`, `region` o `department`. |
| `indicator_code` | enum | Opcional: `monetary_poverty_rate`, `monetary_poverty_persons`, `extreme_poverty_rate`, `extreme_poverty_persons`, `gini`, `income_per_capita`, `poverty_line`, `extreme_poverty_line` o `multidimensional_poverty_rate` (IPM). |
| `domain` | enum | Opcional: `total`, `urban` o `rural`. Solo la pobreza multidimensional se divide por dominio. |
| `year_from` | integer | Primer año opcional, inclusive. `0` no pone límite. Por defecto `0`. |
| `year_to` | integer | Último año opcional, inclusive. `0` no pone límite. Por defecto `0`. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Por defecto `100`. |

```bash theme={"dark"}
curl https://api.croma.run/co/dane/poverty/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "territory_code": "44",
        "indicator_code": "multidimensional_poverty_rate",
        "domain": "total"
      }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`.

## IPM municipal

`POST /co/dane/municipal-ipm/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

La pobreza multidimensional del censo de 2018 de un municipio, de todos los
municipios de un departamento, o de los municipios cuyo nombre coincide.

| Campo | Tipo | Notas |
| - | - | - |
| `territory_code` | string | Código DIVIPOLA opcional: 5 dígitos para un municipio (`44001`), 2 para todos los municipios de un departamento (`44`). |
| `query` | string | Palabras opcionales del nombre del municipio, con o sin tildes, p. ej. `medellin`. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Por defecto `100`. |

```bash theme={"dark"}
curl https://api.croma.run/co/dane/municipal-ipm/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "territory_code": "44001" }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`.

## Censo por municipio

`POST /co/dane/census-municipalities/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

El perfil censal de 2018 de un municipio, de todos los municipios de un
departamento, o de los municipios cuyo nombre coincide.

| Campo | Tipo | Notas |
| - | - | - |
| `territory_code` | string | Código DIVIPOLA opcional: 5 dígitos para un municipio (`44001`), 2 para todos los municipios de un departamento (`44`). |
| `query` | string | Palabras opcionales del nombre del municipio, con o sin tildes, p. ej. `medellin`. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Por defecto `100`. |

```bash theme={"dark"}
curl https://api.croma.run/co/dane/census-municipalities/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "territory_code": "44001" }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`.

## Respuesta

Cada respuesta incluye `as_of`: qué tan actualizados están los datos.

### Mercado laboral y pobreza (`results[]`)

| Campo | Notas |
| - | - |
| `series_id` | La identidad de la observación. |
| `territory_code` | Código DIVIPOLA, o null para la nación, las regiones y los grupos de ciudades. |
| `territory_name`, `territory_level` | El territorio como lo nombra el DANE, y su tipo. |
| `domain` | `total`, `urban` o `rural`. |
| `indicator_code`, `indicator` | El indicador, y su nombre en el DANE. |
| `unit` | `percent`, `thousands_of_people`, `cop_per_month` (pesos corrientes por persona al mes) o `coefficient` (Gini). |
| `period`, `period_type`, `period_start` | Solo mercado laboral: el mes (`yyyy-mm`), o el último mes de un trimestre o año móvil. |
| `year` | El año medido. |
| `value` | El valor tal como lo publicó el DANE. |
| `release` | La publicación de la que sale el valor. |
| `document_url`, `source_document_url` | `document_url` es el libro de Excel de DANE del que sale el valor, tal como DANE lo publicó y siempre disponible en ese enlace; `source_document_url` es el mismo libro en DANE. |

### IPM municipal (`results[]`)

`territory_code`, `territory_name`, `department_code`, `department_name`,
`year` (2018), `ipm`, `ipm_urban`, `ipm_rural` (porcentaje de personas en
hogares en pobreza multidimensional), `deprivations[]` (`indicator_code`,
`indicator`, `total`, `urban`, `rural` para cada una de las quince
privaciones), `document_url` y `source_document_url`.

### Censo por municipio (`results[]`)

`territory_code`, `territory_name`, `department_code`, `department_name`,
`year` (2018), `latitude`, `longitude`, `area_km2`, `population`
(`total`, `men`, `women`, `in_households`, `in_group_quarters`), `age`
(grupos de diez años), `education`, `households`, `dwellings` (por tipo y
ocupación), `services` (energía, acueducto, alcantarillado, gas, recolección
de basuras, internet), `estrato` (viviendas según el estrato en que se les
factura la energía: `e1` a `e6` y `unknown`) y `units` (residenciales,
mixtas, no residenciales y lugares especiales de alojamiento). Todos son conteos.

<Note>
  La pobreza monetaria por departamento cubre 23 departamentos y Bogotá: el
  DANE no la publica para Amazonas, Arauca, Casanare, Guainía, Guaviare,
  Putumayo, San Andrés, Vaupés y Vichada. La pobreza multidimensional cubre los
  33\. El mercado laboral nacional excluye las zonas no capitales de la Amazonía
  y la Orinoquía, como lo hace el DANE.
</Note>

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.