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

> As estatísticas oficiais da Colômbia do DANE: séries de mercado de trabalho para a nação e 32 cidades, pobreza monetária e multidimensional por departamento, e o censo de 2018 e a pobreza multidimensional de cada município, por código DIVIPOLA.

As estatísticas oficiais do Departamento Administrativo Nacional de
Estadística (DANE): o mercado de trabalho da pesquisa domiciliar (GEIH), a
pobreza monetária e multidimensional, e o censo nacional de 2018, com cada
território identificado pelo seu código DIVIPOLA para cruzar as séries com
qualquer outra fonte por departamento ou município.

Cada série está organizada e pronta para consultar: a taxa de desocupação de
uma cidade ao longo de vinte anos, a pobreza multidimensional de cada
departamento ou a distribuição por estrato dos domicílios de um município,
cada uma em uma única chamada rápida.

<Note>
  A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
</Note>

## Mercado de trabalho

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

As séries do mercado de trabalho, filtradas por qualquer combinação de
território, indicador, tipo de período, domínio e datas. O período mais
recente primeiro.

| Campo | Tipo | Notas |
| - | - | - |
| `territory_code` | string | Código DIVIPOLA opcional: 2 dígitos para um departamento (`44`), 5 para um município (`44001`). Uma área metropolitana responde ao código do seu município núcleo. |
| `territory_level` | enum | Opcional: `national`, `region`, `department`, `metropolitan_area`, `city` ou `city_aggregate` (um grupo de cidades, p. ex. as 13 principais). |
| `indicator_code` | enum | Opcional: `unemployment_rate` (TD), `employment_rate` (TO), `participation_rate` (TGP), `underemployment_rate` (TS), `working_age_share`, as taxas combinadas de subutilização, ou uma população em milhares (`population`, `labour_force`, `employed`, `unemployed`, ...). |
| `period_type` | enum | Opcional: `monthly` (a nação e as 13 cidades principais), `rolling_quarter` (trimestre móvel, 23 cidades e áreas metropolitanas) ou `rolling_year` (ano móvel, 32 cidades). Um período móvel é datado pelo seu último mês. |
| `domain` | enum | Opcional: `total` ou `urban` (cabeceras, só nacional). |
| `from_date` | string | Opcional. Primeiro mês (`yyyy-mm-dd`, conta o mês em que cai). |
| `to_date` | string | Opcional. Último mês (`yyyy-mm-dd`, inclusive). |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Padrão `100`. Por padrão `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"
      }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`.

## Pobreza

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

A pobreza monetária e multidimensional, filtrada por território, indicador,
domínio e anos. O ano mais recente primeiro.

| Campo | Tipo | Notas |
| - | - | - |
| `territory_code` | string | Código DIVIPOLA opcional de 2 dígitos de um departamento, p. ex. `44` (La Guajira). |
| `territory_level` | enum | Opcional: `national`, `region` ou `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` ou `multidimensional_poverty_rate` (IPM). |
| `domain` | enum | Opcional: `total`, `urban` ou `rural`. Só a pobreza multidimensional é dividida por domínio. |
| `year_from` | integer | Primeiro ano opcional, inclusive. `0` não define limite. Por padrão `0`. |
| `year_to` | integer | Último ano opcional, inclusive. `0` não define limite. Por padrão `0`. |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Padrão `100`. Por padrão `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"
      }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`.

## IPM municipal

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

A pobreza multidimensional do censo de 2018 de um município, de todos os
municípios de um departamento, ou dos municípios cujo nome coincide.

| Campo | Tipo | Notas |
| - | - | - |
| `territory_code` | string | Código DIVIPOLA opcional: 5 dígitos para um município (`44001`), 2 para todos os municípios de um departamento (`44`). |
| `query` | string | Palavras opcionais do nome do município, com ou sem acentos, p. ex. `medellin`. |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Padrão `100`. Por padrão `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" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`.

## Censo por município

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

O perfil censitário de 2018 de um município, de todos os municípios de um
departamento, ou dos municípios cujo nome coincide.

| Campo | Tipo | Notas |
| - | - | - |
| `territory_code` | string | Código DIVIPOLA opcional: 5 dígitos para um município (`44001`), 2 para todos os municípios de um departamento (`44`). |
| `query` | string | Palavras opcionais do nome do município, com ou sem acentos, p. ex. `medellin`. |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Padrão `100`. Por padrão `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" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`.

## Resposta

Cada resposta traz `as_of`: o quão atuais são os dados.

### Mercado de trabalho e pobreza (`results[]`)

| Campo | Notas |
| - | - |
| `series_id` | A identidade da observação. |
| `territory_code` | Código DIVIPOLA, ou null para a nação, as regiões e os grupos de cidades. |
| `territory_name`, `territory_level` | O território como o DANE o nomeia, e o seu tipo. |
| `domain` | `total`, `urban` ou `rural`. |
| `indicator_code`, `indicator` | O indicador, e o seu nome no DANE. |
| `unit` | `percent`, `thousands_of_people`, `cop_per_month` (pesos correntes por pessoa ao mês) ou `coefficient` (Gini). |
| `period`, `period_type`, `period_start` | Só mercado de trabalho: o mês (`yyyy-mm`), ou o último mês de um trimestre ou ano móvel. |
| `year` | O ano medido. |
| `value` | O valor como o DANE o publicou. |
| `release` | A publicação de onde sai o valor. |
| `document_url`, `source_document_url` | `document_url` é a planilha do DANE de onde sai o valor, exatamente como o DANE a publicou e sempre disponível nesse link; `source_document_url` é a mesma planilha no DANE. |

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

`territory_code`, `territory_name`, `department_code`, `department_name`,
`year` (2018), `ipm`, `ipm_urban`, `ipm_rural` (percentual de pessoas em
domicílios em pobreza multidimensional), `deprivations[]` (`indicator_code`,
`indicator`, `total`, `urban`, `rural` para cada uma das quinze
privações), `document_url` e `source_document_url`.

### Censo por município (`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`
(faixas de dez anos), `education`, `households`, `dwellings` (por tipo e
ocupação), `services` (energia, água, esgoto, gás, coleta de lixo,
internet), `estrato` (domicílios pelo estrato em que a energia é faturada:
`e1` a `e6` e `unknown`) e `units` (residenciais, mistas, não
residenciais e alojamentos coletivos). Todos são contagens.

<Note>
  A pobreza monetária por departamento cobre 23 departamentos e Bogotá: o DANE
  não a publica para Amazonas, Arauca, Casanare, Guainía, Guaviare, Putumayo,
  San Andrés, Vaupés e Vichada. A pobreza multidimensional cobre os 33. O
  mercado de trabalho nacional exclui as zonas não capitais da Amazônia e da
  Orinoquía, como faz o DANE.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>


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