---
title: "TerriData Indicators Search"
method: POST
path: "/co/terridata/indicators-search/v1"
tags: ["Colombia", "DNP TerriData"]
---

# TerriData Indicators Search

`POST /co/terridata/indicators-search/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/terridata/indicators-search/v1`
- Auth: HTTP bearer

Search the catalog of Colombia's territorial statistics (DNP TerriData) by words in the indicator's name (Spanish) and by dimension (`14` poverty, `04` education, `05` health, `16` labour market, `07` public finance, ...). Returns each indicator's nine-digit code, unit, producing agency, how many territories report it and the years it spans. Use the code with the series and ranking endpoints. Served by Croma (`as_of` says how current the data is).

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `query` string: Optional words to find in the indicator's name, in Spanish, e.g. `pobreza multidimensional`, `cobertura neta`, `homicidios`.
  - `dimension_code` '' | '11' | '12' | '13' | '14' | '15' | '16' | '19' | '20' | '22' | '25' | '26' | '27' | '28' | '29' | '30' | '31' | '01' | '02' | '03' | '04' | '05' | '06' | '07' | '08': Optional two-digit dimension: `14` poverty, `04` education, `05` health, `16` labour market, `07` public finance, `12` economy, `06` safety, `03` housing and public services, `02` demographics. Empty searches every dimension.
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Results per page (1-100).

## Response `200`

Successful response

- TerridataIndicatorsSearchResponse
  - `data` TerridataIndicatorsSearchData, required
    - `as_of` string, nullable, required
    - `query` string, required
    - `dimension_code` string, nullable, required
    - `total` integer, required
    - `total_is_exact` boolean, required: False when there are more than 1000 matches and `total` is a floor.
    - `page` integer, required
    - `per_page` integer, required
    - `total_pages` integer, required
    - `count` integer, required
    - `indicators` object[], required
      - `indicator_code` string, required: Nine-digit indicator code.
      - `indicator` string, required: The indicator's name, in Spanish.
      - `dimension_code` string, required: Two-digit dimension code.
      - `dimension` string, required
      - `subcategory` string, nullable, required
      - `unit` string, nullable, required
      - `data_source` string, nullable, required
      - `territories` integer, required: How many territories have a value for it.
      - `municipalities` integer, required: How many municipalities have a value for it.
      - `first_year` integer, required
      - `last_year` integer, required
      - `observations` integer, required: How many values the panel holds for it, across territories and years.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)