APIHub
Back to Explore

Airport & City Search

Before using this API, we recommend you read our **[Authorization Guide](https://developers.amadeus.com/self-service/apis-docs/guides/authorization-262)** for more information on how to generate an access token.

Uncategorized
none
HTTPS
CORS: Unknown
Visit official documentation

Latency

910ms p95

Uptime

0.0% 30d

Playground

Verified

live

Endpoints

REST · JSON
GET

/reference-data/locations

Returns a list of airports and cities matching a given keyword.

  • subType (query, required) — sub type of the location (AIRPORT and/or CITY)
  • keyword (query, required) — keyword that should represent the start of a word in a city or airport name or code. Supported charaters are: A-Za-z0-9./:-'()"
  • countryCode (query) — Country code of the location using [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code format (e.g. US).
  • page[limit] (query) — maximum items in one page
  • page[offset] (query) — start index of the requested page
  • sort (query) — defines on which attribute the sorting will be done: * analytics.travelers.score - sort by the number of travelers by airport or city, the airports and cities with the highest traffic are on top of the results
  • view (query) — select the level of information of the reply: * LIGHT - Gives only the IATACode, name, detailedName, cityName and countryName * FULL - Adds on top of the LIGHT information the timeZoneOffset, geocode, detailed address and travelers.score default option is FULL
GET

/reference-data/locations/{locationId}

Returns a specific airports or cities based on its id.

  • locationId (path, required) — identifier of the location

2 endpoints auto-detected

curl -X GET \
  "https://test.api.amadeus.com/v1/reference-data/locations"

test.api.amadeus.com · HTTPS only