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

> Las estadísticas territoriales de Colombia del DNP: unos 1.750 indicadores de pobreza, educación, salud, trabajo, finanzas públicas, seguridad y más, para la nación, cada departamento y cada municipio, año a año.

TerriData es el panel de estadísticas territoriales del Departamento Nacional de
Planeación (DNP). Reúne, para Colombia, sus 32 departamentos y cada municipio,
los indicadores que publican el DANE, los ministerios y otras entidades: pobreza
monetaria y multidimensional, cobertura y resultados educativos, cobertura en
salud y mortalidad, mercado laboral, finanzas públicas municipales y
departamentales, delitos, vivienda y servicios públicos, demografía, ambiente y
más. Cada valor conserva la entidad que lo produjo.

Todo el panel, organizado y listo para consultar: el perfil completo de un
territorio, la historia de un indicador, o todos los municipios ordenados por un
indicador, cada uno 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>

## Buscar indicadores

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

Encuentra indicadores por nombre y dimensión. Empieza aquí para obtener el
código que usan los demás endpoints.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Opcional. Palabras a buscar en el nombre del indicador, p. ej. `pobreza multidimensional`. |
| `dimension_code` | enum | Opcional. Dimensión de dos dígitos, p. ej. `14` pobreza, `04` educación, `05` salud, `16` mercado laboral, `07` finanzas públicas. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-100. Por defecto `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" }'
```

Devuelve `as_of`, los filtros aplicados, `total`, `total_is_exact`, `page`,
`per_page`, `total_pages`, `count` e `indicators[]` (ver abajo).

## Series por territorio

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

Devuelve los indicadores de un territorio, cada uno con el valor de todos sus
años.

| Campo | Tipo | Notas |
| - | - | - |
| `territory_code` | string | **Obligatorio.** Código DANE de cinco dígitos: un municipio (`05001` Medellín), un departamento (`05000` Antioquia) o `01001` para Colombia. |
| `indicator_code` | string | Opcional. El código de nueve dígitos de un indicador, de la búsqueda de indicadores. |
| `dimension_code` | enum | Opcional. Dimensión de dos dígitos, p. ej. `14` pobreza, `04` educación, `05` salud, `16` mercado laboral, `07` finanzas públicas. |
| `query` | string | Opcional. Palabras a buscar en el nombre del indicador, p. ej. `pobreza multidimensional`. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-100. Por defecto `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" }'
```

Devuelve `as_of`, `found`, el territorio, los filtros aplicados, `total`,
`total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `series[]` (ver abajo).

## Ranking

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

Compara todos los municipios o departamentos en un indicador.

| Campo | Tipo | Notas |
| - | - | - |
| `indicator_code` | string | **Obligatorio.** El código de nueve dígitos del indicador, de la búsqueda de indicadores. |
| `year` | integer | Opcional. El año a comparar, p. ej. `2024`. `0` (por defecto) compara el valor más reciente de cada territorio. Por defecto `0`. |
| `level` | enum | Opcional. `municipality` (por defecto) o `department`. Por defecto `municipality`. |
| `department_code` | string | Opcional. Código DANE de dos dígitos: solo los municipios de ese departamento. |
| `order` | enum | Opcional. `desc` (mayor primero, por defecto) o `asc`. Por defecto `desc`. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-100. Por defecto `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 }'
```

Devuelve `as_of`, `found`, el indicador con su unidad y entidad, los filtros
aplicados, `total`, `page`, `per_page`, `total_pages`, `count` y `results[]` (ver abajo).

## Respuesta

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

### `series[]`

| Campo | Notas |
| - | - |
| `series_id` | `<territory_code>-<indicator_code>`. |
| `territory_code`, `territory_name`, `territory_level` | El territorio: código DANE de cinco dígitos, nombre, y `country`, `department` o `municipality`. |
| `department_code`, `department_name` | Su departamento (`01`, `Colombia` para la nación). |
| `indicator_code`, `indicator` | Código de nueve dígitos y nombre del indicador. |
| `dimension_code`, `dimension`, `subcategory` | Dónde se ubica el indicador en el panel. |
| `unit` | Unidad de medida (`Porcentaje`, `Número`, `Pesos corrientes`, ...). |
| `data_source` | La entidad que produjo la cifra (`DANE`, `MEN`, `DNP`, ...). |
| `first_year`, `last_year` | Los años que abarca la serie. |
| `latest_value`, `latest_text` | El valor más reciente, como número o como texto. |
| `observations[]` | Todos los valores, del más antiguo al más reciente: `{ year, month, value, text }`. `month` viene cuando la cifra es mensual o tomada a un corte. |

### `indicators[]`

`indicator_code`, `indicator`, `dimension_code`, `dimension`, `subcategory`, `unit`, `data_source`, `territories` y `municipalities` (cuántos lo reportan), `first_year`, `last_year` y `observations` (cuántos valores tiene el panel para él).

### `results[]` (ranking)

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

Los números son números; los nombres, unidades y categorías quedan en español tal como los escribe la fuente.

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