DANE

The official statistics of the Departamento Administrativo Nacional de Estadística (DANE): the labour market from the household survey (GEIH), monetary and multidimensional poverty, and the 2018 national census, with every territory keyed by its DIVIPOLA code so the series join with any other source by department or municipality. Every series is organized and ready to query: the unemployment rate of a city over twenty years, the multidimensional poverty of every department, or the estrato distribution of a municipality’s dwellings, each in one fast call.

The whole source, organized and ready to query: every endpoint on this page answers in milliseconds. Every response carries as_of: how current the data is. How datasets work.

Labour market

POST /co/dane/labour-market/v1 Dataset The labour-market series, filtered by any combination of territory, indicator, period type, domain and dates. Newest period first.

Field	Type	Notes
`territory_code`	string	Optional DIVIPOLA code: 2 digits for a department (`44`), 5 for a municipality (`44001`). A metropolitan area answers to its core municipality’s code.
`territory_level`	enum	Optional: `national`, `region`, `department`, `metropolitan_area`, `city` or `city_aggregate` (a group of cities, e.g. the 13 main cities).
`indicator_code`	enum	Optional: `unemployment_rate` (TD), `employment_rate` (TO), `participation_rate` (TGP), `underemployment_rate` (TS), `working_age_share`, the combined underutilization rates, or a population in thousands (`population`, `labour_force`, `employed`, `unemployed`, …).
`period_type`	enum	Optional: `monthly` (the nation and the 13 main cities), `rolling_quarter` (23 cities and metropolitan areas) or `rolling_year` (32 cities). A rolling period is dated by its last month.
`domain`	enum	Optional: `total` or `urban` (cabeceras, national only).
`from_date`	string	Optional. First month (`yyyy-mm-dd`, the month it falls in counts).
`to_date`	string	Optional. Last month (`yyyy-mm-dd`, inclusive).
`page`	integer	Optional. 1-based page. Default `1`.
`per_page`	integer	Optional. Results per page, 1-500. Default `100`.

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

Returns as_of (how current the data is), the applied filters, total and total_is_exact, page, per_page, total_pages, count and results[].

Poverty

POST /co/dane/poverty/v1 Dataset Monetary and multidimensional poverty, filtered by territory, indicator, domain and years. Most recent year first.

Field	Type	Notes
`territory_code`	string	Optional 2-digit DIVIPOLA code of a department, e.g. `44` (La Guajira).
`territory_level`	enum	Optional: `national`, `region` or `department`.
`indicator_code`	enum	Optional: `monetary_poverty_rate`, `monetary_poverty_persons`, `extreme_poverty_rate`, `extreme_poverty_persons`, `gini`, `income_per_capita`, `poverty_line`, `extreme_poverty_line` or `multidimensional_poverty_rate` (IPM).
`domain`	enum	Optional: `total`, `urban` or `rural`. Only multidimensional poverty is split by domain.
`year_from`	integer	Optional first year, inclusive. `0` sets no bound. Default `0`.
`year_to`	integer	Optional last year, inclusive. `0` sets no bound. Default `0`.
`page`	integer	Optional. 1-based page. Default `1`.
`per_page`	integer	Optional. Results per page, 1-500. Default `100`.

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

Returns as_of (how current the data is), the applied filters, total and total_is_exact, page, per_page, total_pages, count and results[].

Municipal IPM

POST /co/dane/municipal-ipm/v1 Dataset The 2018 census multidimensional poverty of a municipality, of every municipality of a department, or of the municipalities whose name matches.

Field	Type	Notes
`territory_code`	string	Optional DIVIPOLA code: 5 digits for one municipality (`44001`), 2 for every municipality of a department (`44`).
`query`	string	Optional words of the municipality’s name, accents optional, e.g. `medellin`.
`page`	integer	Optional. 1-based page. Default `1`.
`per_page`	integer	Optional. Results per page, 1-500. Default `100`.

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

Returns as_of (how current the data is), the applied filters, total and total_is_exact, page, per_page, total_pages, count and results[].

Census by municipality

POST /co/dane/census-municipalities/v1 Dataset The 2018 census profile of a municipality, of every municipality of a department, or of the municipalities whose name matches.

Field	Type	Notes
`territory_code`	string	Optional DIVIPOLA code: 5 digits for one municipality (`44001`), 2 for every municipality of a department (`44`).
`query`	string	Optional words of the municipality’s name, accents optional, e.g. `medellin`.
`page`	integer	Optional. 1-based page. Default `1`.
`per_page`	integer	Optional. Results per page, 1-500. Default `100`.

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

Returns as_of (how current the data is), the applied filters, total and total_is_exact, page, per_page, total_pages, count and results[].

Response

Every response carries as_of: how current the data is.

Labour market and poverty (`results[]`)

Field	Notes
`series_id`	The observation’s identity.
`territory_code`	DIVIPOLA code, or null for the nation, regions and groups of cities.
`territory_name`, `territory_level`	The territory as DANE names it, and its kind.
`domain`	`total`, `urban` or `rural`.
`indicator_code`, `indicator`	The indicator, and its name at DANE.
`unit`	`percent`, `thousands_of_people`, `cop_per_month` (current pesos per person per month) or `coefficient` (Gini).
`period`, `period_type`, `period_start`	Labour market only: the month (`yyyy-mm`), or the last month of a rolling quarter or year.
`year`	The year measured.
`value`	The value as DANE published it.
`release`	The release the value comes from.
`document_url`, `source_document_url`	`document_url` is the DANE workbook the value comes from, exactly as DANE published it and always available at that link; `source_document_url` is the same workbook at DANE.

Municipal IPM (`results[]`)

territory_code, territory_name, department_code, department_name, year (2018), ipm, ipm_urban, ipm_rural (percent of people in multidimensionally poor households), deprivations[] (indicator_code, indicator, total, urban, rural for each of the fifteen deprivations), document_url and source_document_url.

Census by municipality (`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 (ten-year bands), education, households, dwellings (by type and occupancy), services (electricity, water, sewerage, gas, garbage collection, internet), estrato (dwellings by the estrato they are billed in for electricity: e1 to e6 and unknown) and units (residential, mixed, non-residential and group quarters). All counts.

Monetary poverty by department covers 23 departments and Bogotá: DANE does not publish it for Amazonas, Arauca, Casanare, Guainía, Guaviare, Putumayo, San Andrés, Vaupés and Vichada. Multidimensional poverty covers all 33. The national labour market leaves out the non-capital areas of Amazonía and Orinoquía, as DANE does.

Full reference

Schemas, all response fields, and an interactive playground.

Get Started

Request types

Monitors

Countries

Labour market

Poverty

Municipal IPM

Census by municipality

Response

Labour market and poverty (`results[]`)

Municipal IPM (`results[]`)

Census by municipality (`results[]`)

Full reference

​Labour market

​Poverty

​Municipal IPM

​Census by municipality

​Response

​Labour market and poverty (results[])

​Municipal IPM (results[])

​Census by municipality (results[])

Full reference

Labour market

Poverty

Municipal IPM

Census by municipality

Response

Labour market and poverty (`results[]`)

Municipal IPM (`results[]`)

Census by municipality (`results[]`)