---
title: "IGAC Sectors Search"
method: POST
path: "/co/igac/sectors-search/v1"
tags: ["Colombia", "IGAC"]
---

# IGAC Sectors Search

`POST /co/igac/sectors-search/v1`

## Request

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

List the cadastral sectors of a municipality in Colombia's national cadastre, urban and rural, each with its polygon, and the municipality's urban perimeters (the line dividing urban from rural land) with the centre's name and appraisal regime. Served by Croma.

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

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `municipality_code` string, required: Five-digit DANE code of the municipality, e.g. `17013` for Aguadas or `52001` for Pasto.
  - `zone` '' | 'urban' | 'rural': Optional: `urban` or `rural`.
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Results per page (1-50); every result carries its geometry.

## Response `200`

Successful response

- IgacSectorsSearchResponse
  - `data` IgacSectorsSearchData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `municipality_code` string, required
    - `zone` string, nullable, required
    - `total` number, required: Matches, counted up to 1000.
    - `total_is_exact` boolean, required: False when more than 1000 match: `total` is then 1000, and the pages go on.
    - `page` number, required
    - `per_page` number, required
    - `total_pages` number, required: Pages over `total`; there are more when `total_is_exact` is false.
    - `count` number, required
    - `sectors` object[], required
      - `id` string, required: `urban:<code>` or `rural:<code>`.
      - `code` string, required: The sector code.
      - `zone` 'urban' | 'rural', required
      - `department_code` string, required
      - `municipality_code` string, required
      - `part_count` number, required
      - `geometry` object, nullable, required: The feature's geometry as GeoJSON in WGS84, exactly as IGAC draws it; referential, it does not certify boundaries.
        - `type` string, required: `Polygon`, `MultiPolygon`, `LineString`, `MultiLineString` or `Point`.
        - `coordinates` unknown, required
      - `geometry_url` string, nullable, required: Set when the geometry is too large to carry inline (a rural zone can run to tens of MB): the same GeoJSON geometry, kept by us, and `geometry` is null.
    - `urban_perimeters` object[], required
      - `id` string, required: `<municipality_code>:<name_code>`.
      - `department_code` string, required
      - `municipality_code` string, required
      - `name` string, nullable, required: The urban centre's geographic name.
      - `name_code` string, nullable, required
      - `appraisal_type` string, nullable, required: IGAC's appraisal regime for the centre (tipo de avalúo).
      - `part_count` number, required
      - `geometry` object, nullable, required: The feature's geometry as GeoJSON in WGS84, exactly as IGAC draws it; referential, it does not certify boundaries.
        - `type` string, required: `Polygon`, `MultiPolygon`, `LineString`, `MultiLineString` or `Point`.
        - `coordinates` unknown, required
      - `geometry_url` string, nullable, required: Set when the geometry is too large to carry inline (a rural zone can run to tens of MB): the same GeoJSON geometry, kept by us, and `geometry` is null.

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