---
title: "Regions"
method: GET
path: "/regions"
tags: ["Geography"]
---

# Regions

`GET /regions`

## Request

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

Returns a paginated list of geographic regions available in the system. Regions represent broad areas that may span multiple cities or countries, defined by polygon boundaries.

## Query parameters

- `product` string, required
- `language` string, required

## Response `200`

OK

- object
  - `items` object[]: List of regions.
    - `id` string: Internal numeric identifier of the region.
    - `gid` string: Global identifier combining type and id. E.g.: `REG_34046`.
    - `descriptions` object: Localized region names keyed by language code. E.g.: `{ "es": "Alpes Suizos", "pt": "Alpes Suíços", "en": "Swiss Alps" }`.
    - `forced_city_ids` string[]: List of city IDs that are explicitly included in this region.
    - `boundary` object: Polygon defining the outer boundary of the region.
      - `type` 'POLYGON': Geometry type. Always `POLYGON`.
      - `coordinates` object[]: List of points that define the polygon boundary.
        - `type` 'POINT': Geometry type. Always `POINT`.
        - `latitude` number: Latitude coordinate.
        - `longitude` number: Longitude coordinate.
    - `zones` object[]: List of sub-polygons within the region. May be empty.
      - `type` 'POLYGON': Geometry type. Always `POLYGON`.
      - `coordinates` object[]: List of points that define the polygon boundary.
        - `type` 'POINT': Geometry type. Always `POINT`.
        - `latitude` number: Latitude coordinate.
        - `longitude` number: Longitude coordinate.
    - `correlated_political_divisions` object: Political divisions (countries, states) that this region is correlated with. May be empty.
      - `country` string[]: List of country IDs this region is correlated with.
    - `related_political_divisions` object: Political divisions related to this region. May be empty.
    - `included_points` object: Points of interest explicitly included in this region, keyed by point type (e.g. `port`). Each key maps to an array of internal IDs. May be empty.
    - `excluded_points` object: Points of interest explicitly excluded from this region, keyed by point type. May be empty.
    - `pictures` object[]: List of pictures associated with the region. 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 regions available.

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