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

> As estatísticas territoriais da Colômbia do DNP: cerca de 1.750 indicadores de pobreza, educação, saúde, trabalho, finanças públicas, segurança e mais, para a nação, cada departamento e cada município, ano a ano.

TerriData é o painel de estatísticas territoriais do Departamento Nacional de
Planeación (DNP) da Colômbia. Reúne, para o país, seus 32 departamentos e cada
município, os indicadores que o DANE, os ministérios e outros órgãos publicam:
pobreza monetária e multidimensional, cobertura e resultados escolares, cobertura
de saúde e mortalidade, mercado de trabalho, finanças públicas municipais e
departamentais, crimes, moradia e serviços públicos, demografia, meio ambiente e
mais. Cada valor mantém o órgão que o produziu.

O painel inteiro, organizado e pronto para consultar: o perfil completo de um
território, a história de um indicador, ou todos os municípios ordenados por um
indicador, cada um 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>

## Buscar indicadores

`POST /co/terridata/indicators-search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Encontra indicadores por nome e dimensão. Comece aqui para obter o código que
os demais endpoints usam.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Opcional. Palavras a buscar no nome do indicador, em espanhol, p. ex. `pobreza multidimensional`. |
| `dimension_code` | enum | Opcional. Dimensão de dois dígitos, p. ex. `14` pobreza, `04` educação, `05` saúde, `16` mercado de trabalho, `07` finanças públicas. |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-100. Por padrão `20`. |

```bash theme={"dark"}
curl https://api.croma.run/co/terridata/indicators-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "pobreza multidimensional" }'
```

Retorna `as_of`, os filtros aplicados, `total`, `total_is_exact`, `page`,
`per_page`, `total_pages`, `count` e `indicators[]` (ver abaixo).

## Séries por território

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

Retorna os indicadores de um território, cada um com o valor de todos os seus
anos.

| Campo | Tipo | Notas |
| - | - | - |
| `territory_code` | string | **Obrigatório.** Código DANE de cinco dígitos: um município (`05001` Medellín), um departamento (`05000` Antioquia) ou `01001` para a Colômbia. |
| `indicator_code` | string | Opcional. O código de nove dígitos de um indicador, da busca de indicadores. |
| `dimension_code` | enum | Opcional. Dimensão de dois dígitos, p. ex. `14` pobreza, `04` educação, `05` saúde, `16` mercado de trabalho, `07` finanças públicas. |
| `query` | string | Opcional. Palavras a buscar no nome do indicador, em espanhol, p. ex. `pobreza multidimensional`. |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-100. Por padrão `20`. |

```bash theme={"dark"}
curl https://api.croma.run/co/terridata/series/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "territory_code": "05001", "dimension_code": "14" }'
```

Retorna `as_of`, `found`, o território, os filtros aplicados, `total`,
`total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `series[]` (ver abaixo).

## Ranking

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

Compara todos os municípios ou departamentos em um indicador.

| Campo | Tipo | Notas |
| - | - | - |
| `indicator_code` | string | **Obrigatório.** O código de nove dígitos do indicador, da busca de indicadores. |
| `year` | integer | Opcional. O ano a comparar, p. ex. `2024`. `0` (padrão) compara o valor mais recente de cada território. Por padrão `0`. |
| `level` | enum | Opcional. `municipality` (padrão) ou `department`. Por padrão `municipality`. |
| `department_code` | string | Opcional. Código DANE de dois dígitos: apenas os municípios desse departamento. |
| `order` | enum | Opcional. `desc` (maior primeiro, padrão) ou `asc`. Por padrão `desc`. |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-100. Por padrão `20`. |

```bash theme={"dark"}
curl https://api.croma.run/co/terridata/ranking/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "indicator_code": "140030015", "per_page": 10 }'
```

Retorna `as_of`, `found`, o indicador com sua unidade e órgão, os filtros
aplicados, `total`, `page`, `per_page`, `total_pages`, `count` e `results[]` (ver abaixo).

## Resposta

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

### `series[]`

| Campo | Notas |
| - | - |
| `series_id` | `<territory_code>-<indicator_code>`. |
| `territory_code`, `territory_name`, `territory_level` | O território: código DANE de cinco dígitos, nome, e `country`, `department` ou `municipality`. |
| `department_code`, `department_name` | Seu departamento (`01`, `Colombia` para a nação). |
| `indicator_code`, `indicator` | Código de nove dígitos e nome do indicador, em espanhol. |
| `dimension_code`, `dimension`, `subcategory` | Onde o indicador se situa no painel. |
| `unit` | Unidade de medida, em espanhol (`Porcentaje`, `Número`, `Pesos corrientes`, ...). |
| `data_source` | O órgão que produziu o número (`DANE`, `MEN`, `DNP`, ...). |
| `first_year`, `last_year` | Os anos que a série abrange. |
| `latest_value`, `latest_text` | O valor mais recente, como número ou como texto. |
| `observations[]` | Todos os valores, do mais antigo ao mais recente: `{ year, month, value, text }`. `month` vem quando o número é mensal ou tomado em um corte. |

### `indicators[]`

`indicator_code`, `indicator`, `dimension_code`, `dimension`, `subcategory`, `unit`, `data_source`, `territories` e `municipalities` (quantos o reportam), `first_year`, `last_year` e `observations` (quantos valores o painel tem para ele).

### `results[]` (ranking)

`rank`, `territory_code`, `territory_name`, `department_code`, `department_name`, `year`, `month` e `value`.

Números são números; nomes, unidades e categorias ficam em espanhol como a fonte os escreve.

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