---
title: "DANE Census by Municipality"
method: POST
path: "/co/dane/census-municipalities/v1"
tags: ["Colombia", "DANE"]
---

# DANE Census by Municipality

`POST /co/dane/census-municipalities/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/dane/census-municipalities/v1`
- Auth: HTTP bearer

The 2018 national population and housing census (CNPV, DANE) for each of Colombia's 1,122 municipalities: people by sex and age, education, households, dwellings by type and occupancy, public services and internet, dwellings by estrato as billed for electricity, and land use. Filter by DIVIPOLA code (a municipality, or every municipality of a department) or by name. 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
  - `territory_code` string: Optional DIVIPOLA code: 2 digits for a department (`44`), 5 for a municipality (`44001`).
  - `query` string: Optional words of the municipality's name, e.g. `riohacha`.
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Results per page (1-500).

## Response `200`

Successful response

- DaneCensusMunicipalitiesResponse
  - `data` DaneCensusMunicipalitiesData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `territory_code` string, nullable, required
    - `query` string, required
    - `total` number, required: Matches, counted up to 1000.
    - `total_is_exact` boolean, required: False when more than 1000 match.
    - `page` number, required
    - `per_page` number, required
    - `total_pages` number, required
    - `count` number, required
    - `results` object[], required
      - `territory_code` string, required: 5-digit DIVIPOLA code of the municipality.
      - `territory_name` string, required: The municipality as DANE names it, e.g. "RIOHACHA".
      - `department_code` string, required: 2-digit DIVIPOLA code of the department.
      - `department_name` string, required
      - `year` number, required: 2018: the census year.
      - `latitude` number, nullable, required: Latitude of the municipality's centroid.
      - `longitude` number, nullable, required: Longitude of the municipality's centroid.
      - `area_km2` number, nullable, required: Area of the municipality in square kilometres.
      - `population` object, required
        - `total` number, nullable, required: People counted.
        - `men` number, nullable, required
        - `women` number, nullable, required
        - `in_households` number, nullable, required: People in private households.
        - `in_group_quarters` number, nullable, required: People in group quarters (LEA: institutions, barracks, prisons).
      - `age` object, required
        - `from_0_to_9` number, nullable, required
        - `from_10_to_19` number, nullable, required
        - `from_20_to_29` number, nullable, required
        - `from_30_to_39` number, nullable, required
        - `from_40_to_49` number, nullable, required
        - `from_50_to_59` number, nullable, required
        - `from_60_to_69` number, nullable, required
        - `from_70_to_79` number, nullable, required
        - `from_80` number, nullable, required
      - `education` object, required
        - `primary` number, nullable, required: People whose last level reached is preschool or primary.
        - `secondary` number, nullable, required
        - `higher` number, nullable, required: Technical, technological or university.
        - `postgraduate` number, nullable, required
        - `none` number, nullable, required
        - `unknown` number, nullable, required
      - `households` number, nullable, required: Households counted.
      - `dwellings` object, required
        - `total` number, nullable, required: Dwellings counted.
        - `house` number, nullable, required
        - `apartment` number, nullable, required
        - `room` number, nullable, required
        - `indigenous_traditional` number, nullable, required
        - `ethnic_traditional` number, nullable, required
        - `other` number, nullable, required
        - `occupied` number, nullable, required: Occupied with people present.
        - `occupied_absent` number, nullable, required: Occupied with every person absent.
        - `temporary` number, nullable, required: Temporary use (holidays, work).
        - `vacant` number, nullable, required
      - `services` object, required
        - `electricity` number, nullable, required: Dwellings with electricity.
        - `no_electricity` number, nullable, required
        - `water` number, nullable, required: Dwellings with piped water (acueducto).
        - `no_water` number, nullable, required
        - `sewerage` number, nullable, required
        - `no_sewerage` number, nullable, required
        - `gas` number, nullable, required: Dwellings with piped natural gas.
        - `no_gas` number, nullable, required
        - `garbage_collection` number, nullable, required
        - `no_garbage_collection` number, nullable, required
        - `internet` number, nullable, required
        - `no_internet` number, nullable, required
      - `estrato` object, required
        - `e1` number, nullable, required: Dwellings billed for electricity in estrato 1.
        - `e2` number, nullable, required
        - `e3` number, nullable, required
        - `e4` number, nullable, required
        - `e5` number, nullable, required
        - `e6` number, nullable, required
        - `unknown` number, nullable, required: Dwellings that do not know or have no estrato.
      - `units` object, required
        - `residential` number, nullable, required: Units used as dwellings.
        - `mixed` number, nullable, required: Units used as dwellings and for another use.
        - `non_residential` number, nullable, required
        - `group_quarters` number, nullable, required

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