TerriData Ranking

Rank Colombia's municipalities (or departments) on one indicator of the DNP's territorial statistics (TerriData) for a year, or on each territory's latest value: highest or lowest first, optionally within one department. Returns rank, territory, year and value, plus the indicator's unit and producing agency. Served by Croma (as_of says how current the data is).

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

post/co/terridata/ranking/v1

Request

Base URL: https://api.croma.run
URL: https://api.croma.run/co/terridata/ranking/v1
Auth: HTTP bearer

Headers

Idempotency-Keystring

Example:0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b

Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.

Request body

indicator_codestring required

Nine-digit indicator code, as the indicator search returns it.

yearinteger

Optional year to compare, e.g. 2024. 0 compares each territory's latest value.

level'municipality' | 'department'

Optional level to compare: municipality (default) or department.

department_codestring

Optional two-digit DANE code of a department, e.g. 05 for Antioquia: only its municipalities are compared.

order'desc' | 'asc'

Optional order: desc (highest value first, the default) or asc.

pageinteger

1-based page number for paginated results.

per_pageinteger

Results per page (1-100).

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.