Airport & City Search API

by amadeus.com

Overview

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. Please also be aware that our test environment is based on a subset of the production, in test this API only contains data from the United States, Spain, United Kingdom, Germany and India.

Airport & City Search is a transportation API from amadeus.com. It needs no API key. It is served over HTTPS. Its OpenAPI description documents 2 endpoints.

At a glance

Authentication: No auth
HTTPS: Yes
CORS: Unknown
Category: Transportation
Base URL: https://test.api.amadeus.com/v1
Version: 1.2.3
Endpoints: 2
OpenAPI: Specification ↗
Spec updated: 2023-03-24

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL

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

JavaScript

const response = await fetch("https://test.api.amadeus.com/v1/reference-data/locations", {
  method: "GET",
  headers: {
    "Accept": "application/json",
  },
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.request(
    "GET",
    "https://test.api.amadeus.com/v1/reference-data/locations",
    headers={
    "Accept": "application/json",
    },
    timeout=30,
)
print(response.json())

Endpoints

Method	Path	What it does
GET	`/reference-data/locations`	Returns a list of airports and cities matching a given keyword.
GET	`/reference-data/locations/{locationId}`	Returns a specific airports or cities based on its id.