---
title: "Geo Points"
method: GET
path: "/geo-points"
tags: ["Geography"]
---

# Geo Points

`GET /geo-points`

## Request

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

Returns a paginated list of geographic points of interest (airports, hotels, POIs, parks, theatres, etc.) with their location, type, and multilingual descriptions.

## Query parameters

- `product` string, required
- `language` string, required
- `types` string
- `ratio` string

## Response `200`

OK

- object
  - `items` object[]: List of geographic points matching the query.
    - `id` string: Internal numeric identifier of the geo point.
    - `gid` string: Global identifier combining type prefix and id. The prefix reflects the entity type. E.g.: `AIR_192635` for airports, `POI_149061` for points of interest.
    - `type` string: Type of the geo point. E.g.: `AIRPORT`, `PLACE_OF_INTEREST`, `SHOPPING_MALL`, `THEATRE`, `BEACH_LAKE`, `AMUSEMENT_PARK`, `THEME_PARK`, `STADIUM`, `PARK_GREEN_SPACE`.
    - `code` string: IATA or internal code of the geo point. Present for airports (e.g. `EZE`). May be empty or absent for other types.
    - `descriptions` object: Localized names keyed by language code.
    - `aliases` string[]: List of alternative names for the geo point. Not always present.
    - `location` object: Geographic coordinates of the point.
      - `type` 'POINT': Geometry type. Always `POINT`.
      - `latitude` number: Latitude coordinate.
      - `longitude` number: Longitude coordinate.
    - `city_id` string: Internal numeric identifier of the city this point belongs to.
    - `city_gid` string: Global identifier of the city. E.g.: `CIT_982`.
    - `commercial` boolean: Indicates whether this is a commercial point. Not always present.
    - `manual_order` integer: Manual ordering weight used to prioritize results. Not always present.
    - `place_id` string: External place identifier (e.g. Google Place ID). Not always present.
    - `pictures` object[]: List of pictures associated with the geo point. 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 geo points 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)