---
title: "Zones"
method: GET
path: "/zones"
tags: ["Geography"]
---

# Zones

`GET /zones`

## Request

- Base URL: `https://api-dev.despegar.com/v3`
- URL: `https://api-dev.despegar.com/v3/zones`
- Auth: API key in header `x-apikey`

Returns a paginated list of zones (neighborhoods or sub-areas within cities) for a given country, including their polygon boundaries and geographic metadata.

## Query parameters

- `country_id` string, required
- `product` string, required
- `language` string, required
- `min_distance` number

## Response `200`

OK

- object
  - `items` object[]: List of zones.
    - `id` string: Internal numeric identifier of the zone.
    - `gid` string: Global identifier combining type and id. E.g.: `ZON_183034`.
    - `type` string: Zone classification type. E.g.: `NEIGHBOURHOOD`.
    - `descriptions` object: Localized zone names keyed by language code.
    - `aliases` string[]: List of alternative names for the zone. Not always present.
    - `city_id` string: Internal numeric identifier of the city this zone belongs to.
    - `city_gid` string: Global identifier of the city. E.g.: `CIT_982`.
    - `relevance` integer: Relevance score used to rank zones. Higher values indicate more relevant zones.
    - `provider` string: Source of the zone data. E.g.: `DESPEGAR`. Not always present.
    - `location` object: Polygon defining the geographic boundaries of the zone.
      - `type` 'POLYGON'
      - `latitude` number: Reference latitude of the zone centroid.
      - `longitude` number: Reference longitude of the zone centroid.
      - `coordinates` object[]: List of points that define the polygon boundary.
        - `type` 'POINT'
        - `latitude` number
        - `longitude` number
    - `configurations` string[]: List of product and platform configurations in which this zone is available.
    - `pictures` object[]: List of pictures associated with the zone. Always empty.
    - `last_update_date` string, date-time: Date and time of the last update to this record.
  - `paging` object: Pagination information for the response.
    - `offset` integer: Starting index of the returned results.
    - `limit` integer: Maximum number of results returned per page.
    - `total` integer: Total number of zones available for the given country.

## Other responses

- `400`: Bad Request. A required query parameter is missing or invalid.
- `401`: Unauthorized. The request is missing a valid API key.
- `500`: Internal Server Error.

---

[API](https://skmtc.dev/despegar/apis/geography-api.md) - [All operations](https://skmtc.dev/despegar/apis/geography-api/llms.txt) - [OpenAPI document](https://skmtc.dev/despegar/apis/geography-api/revisions/68ba7194d527?raw)