Overview
- POST /v1/security/oauth2/token
- GET /v1/security/oauth2/token/{access_token}
- PARAMETERS /v1/security/oauth2/token/{access_token}
- GET /v2/shopping/flight-offers
- POST /v2/shopping/flight-offers
- POST /v1/shopping/flight-offers/pricing
- POST /v1/booking/flight-orders
- GET /v1/booking/flight-orders/{flightOrderId}
- DELETE /v1/booking/flight-orders/{flightOrderId}
- PARAMETERS /v1/booking/flight-orders/{flightOrderId}
- GET /v1/shopping/seatmaps
- POST /v1/shopping/seatmaps
- POST /v1/shopping/flight-offers/upselling
- GET /v1/analytics/itinerary-price-metrics
- POST /v2/shopping/flight-offers/prediction
- GET /v1/shopping/flight-destinations
- GET /v1/shopping/flight-dates
- POST /v1/shopping/availability/flight-availabilities
- GET /v1/reference-data/recommended-locations
- GET /v2/schedule/flights
- GET /v1/travel/predictions/flight-delay
- GET /v1/airport/predictions/on-time
- GET /v1/reference-data/locations
- GET /v1/reference-data/locations/CMUC
- GET /v1/reference-data/locations/airports
- GET /v1/airport/direct-destinations
- GET /v2/reference-data/urls/checkin-links
- GET /v1/reference-data/airlines
- GET /v1/airline/destinations
- GET /v1/reference-data/locations/pois
- GET /v1/reference-data/locations/pois/by-square
- GET /v1/reference-data/locations/pois/9CB40CB5D0
- GET /v1/shopping/activities
- GET /v1/shopping/activities/4615
- GET /v1/shopping/activities/by-square
- GET /v1/reference-data/locations/cities
- POST /v1/shopping/transfer-offers
- POST /v1/ordering/transfer-orders
- POST /v1/ordering/transfer-orders/{transferOrderId}/transfers/cancellation
- PARAMETERS /v1/ordering/transfer-orders/{transferOrderId}/transfers/cancellation
- GET /v1/travel/analytics/air-traffic/traveled
- GET /v1/travel/analytics/air-traffic/booked
- GET /v1/travel/analytics/air-traffic/busiest-period
- GET /v1/location/analytics/category-rated-areas
- GET /v1/reference-data/locations/hotels/by-city
- GET /v3/shopping/hotel-offers
- POST /v1/booking/hotel-bookings
- GET /v1/reference-data/locations/hotels/by-hotels
- GET /v1/reference-data/locations/hotels/by-geocode
- GET /v3/shopping/hotel-offers/{hotelOfferId}
- PARAMETERS /v3/shopping/hotel-offers/{hotelOfferId}
- GET /v2/e-reputation/hotel-sentiments
- GET /v1/reference-data/locations/hotel
- POST /v3/travel/trip-parser
- GET /v1/travel/predictions/trip-purpose
POST /v1/security/oauth2/token
Summary: Access Granted Client Credentials
To request an access token you need to send a POST request with the following body parameters to the authorization server:
- “grant_type” with the value “client_credentials"
- "client_id” with your API Key.
- ”client_secret” with your API Secret.
OpenAPI snippet URL
GET /v1/security/oauth2/token/{access_token}
Summary: Get Token Information
Retrieves information about an existing token. The token is passed as URL parameter, for example:
https://test.api.amadeus.com/v1/security/oauth2/token/AbCdEfGHI123456
OpenAPI snippet URL
PARAMETERS /v1/security/oauth2/token/{access_token}
OpenAPI snippet URL
GET /v2/shopping/flight-offers
Summary: Step 1: Flight Offers Search GET
The Flight Offers Search API allows to get cheapest flight recommendations and prices on a given journey. It provides a list of flight recommendations and fares from a given origin (city or airport), for a given date (or date range) and for a given list of passengers. Additional information such as bag allowance, first ancillary bag prices or fare details are also provided.
OpenAPI snippet URL
POST /v2/shopping/flight-offers
Summary: Flight Offers Search
The Flight Offers Search API allows to get cheapest flight recommendations and prices on a given journey. It provides a list of flight recommendations and fares from a given origin (city or airport), for a given date (or date range) and for a given list of passengers. Additional information such as bag allowance, first ancillary bag prices or fare details are also provided.
OpenAPI snippet URL
POST /v1/shopping/flight-offers/pricing
Summary: Step 2: Flight Offers Price
The Flight Offers Price REST/JSON API is an open price API that enables you to get or confirm the price of a flight and obtain information about taxes and fees to be applied to the entire journey.
OpenAPI snippet URL
POST /v1/booking/flight-orders
Summary: Step 3: Flight Create Orders
The Flight Create Orders is an API to book flights and ancillary services proposed by the airlines like additional checked bags or seats with extra-legroom. It returns flight order unique ID and details.
OpenAPI snippet URL
GET /v1/booking/flight-orders/{flightOrderId}
Summary: Flight Order Management
The Flight Order Management REST JSON API is an open API that allows you to manipulate a flight order previously created.
OpenAPI snippet URL
DELETE /v1/booking/flight-orders/{flightOrderId}
Summary: Flight Order Management
The Flight Order Management REST JSON API is an open API that allows you to manipulate a flight order previously created.
OpenAPI snippet URL
PARAMETERS /v1/booking/flight-orders/{flightOrderId}
OpenAPI snippet URL
GET /v1/shopping/seatmaps
Summary: Seatmap Display
The Seatmap Display REST/JSON API is an open API that allows you to retrieve the seat map of one or several flights.
OpenAPI snippet URL
POST /v1/shopping/seatmaps
Summary: Seatmap Display
The Seatmap Display REST/JSON API is an open API that allows you to retrieve the seat map of one or several flights.
OpenAPI snippet URL
POST /v1/shopping/flight-offers/upselling
Summary: Branded Fares Upsell
Branded fares, or fare families, are airline-created fares that combine different products and services like bags, sets, meals, free cancellation or miles accrual. The Amadeus Branded Fare Upsell API provides the branded fares available for a given flight, along with pricing and a fare description. This enables you to increase booking revenue by recommending higher-value fares during the shopping phase.
The Branded Fares Upsell API is easily integrated into the Amadeus REST/JSON flight booking engine and provides branded fare options for flights returned by the Flight Offers Search API.
OpenAPI snippet URL
GET /v1/analytics/itinerary-price-metrics
Summary: Flight Price Analysis
When booking a flight, travelers need to be confident that they’re getting a good deal. The Flight Price Analysis API uses an Artificial Intelligence algorithm trained on Amadeus historical flight booking data to show how current flight prices compare to historical fares and whether the price of a flight is below or above average.
For a given city pair and departure date, the API provides historical prices in a quartile distribution, including minimum, maximum and average price.
OpenAPI snippet URL
POST /v2/shopping/flight-offers/prediction
Summary: Flight Choice Prediction
The Flight Choice Prediction API allows developers to forecast traveler choices in the context of search & shopping. Exposing machine learning & AI services for travel, this API consumes the output of the Flight Low-fare Search API and returns augmented content with probabilities of choices for each flight offers.
OpenAPI snippet URL
GET /v1/shopping/flight-destinations
Summary: Flight Inspiration Search
The Flight Inspiration Search REST/JSON API enables you get a list of destinations from a given origin (city or airport) and the cheapest price for each one. The API can tell you the price of flying from a given origin to some destination, for a trip of a given duration, that falls within a given date range.
OpenAPI snippet URL
GET /v1/shopping/flight-dates
Summary: Flight Cheapest Date Search
The Flight Cheapest Date Search REST/JSON API is an open search API that enables you to find the cheapest dates to a given city or airport.
The API returns a list of flight-date options containing the flight dates and the flight price. Links to the Flight Low-fare Search API are also provided to allow you to confirm the price and availability of the fare.
OpenAPI snippet URL
POST /v1/shopping/availability/flight-availabilities
Summary: Flight Availabilities Search
The Amadeus Flight Availability API provides a list of flights with seats for sale on a given itinerary and the quantity of seats available in different fare classes. In addition to availability, the API also returns carrier and aircraft information, the departure and arrival terminals, schedule, and route.
OpenAPI snippet URL
GET /v1/reference-data/recommended-locations
Summary: Travel Recommendations
Travel Recommendations
OpenAPI snippet URL
GET /v2/schedule/flights
Summary: On Demand Flight Status
The Flight Status API provides real-time flight schedule data including up-to-date departure and arrival times, terminal and gate information, flight duration and real-time delay status. Help travelers track the live status of their flight and enjoy a stress-free trip.
OpenAPI snippet URL
GET /v1/travel/predictions/flight-delay
Summary: Flight Delay Prediction
The Flight Delay Prediction API allows developers to forecast the chances for a flight to be delayed.
OpenAPI snippet URL
GET /v1/airport/predictions/on-time
Summary: Airport On-Time Performance
Returns a percentage of on-time flight departures from a given airport.
OpenAPI snippet URL
GET /v1/reference-data/locations
Summary: Airport & City Search by Keyword
The Airport & City Search REST/JSON API provides the full name, IATA code and geographical information of cities or airports that match a given keyword parameter, for use in flight searches.
The response provides a list of cities and/or airports, sorted by travellers’ traffic score, which is based on the estimated yearly number of travellers by airport or city. Airports and cities with the highest traffic are at the top of the list.
This operation allows retrieving the list of locations (airports or cities) that contain a specific keyword in the start of any word in their name or in the start of their IATA code.
OpenAPI snippet URL
GET /v1/reference-data/locations/CMUC
Summary: Airport & City Search by Id
The Airport & City Search REST/JSON API provides the full name, IATA code and geographical information of cities or airports that match a given keyword parameter, for use in flight searches.
The response provides a list of cities and/or airports, sorted by travellers’ traffic score, which is based on the estimated yearly number of travellers by airport or city. Airports and cities with the highest traffic are at the top of the list.
This operation allows retrieving a locations (airports or cities) based on its id.
OpenAPI snippet URL
GET /v1/reference-data/locations/airports
Summary: Airport Nearest Relevant
The Airport Nearest Relevant REST/JSON API returns a list of relevant airports within a radius of 500 km of a given point. The relevance of an airport is based on the estimated yearly flight traffic of the airport and on the distance from the point. The airports are sorted from most relevant to least relevant by default. Other sorting possibilities are offered (by distance, by traffic score).
OpenAPI snippet URL
GET /v1/airport/direct-destinations
Summary: Airport Routes
The Amadeus Airport Routes API helps you find all destinations served by a given airport.
OpenAPI snippet URL
GET /v2/reference-data/urls/checkin-links
Summary: Flight Check-in Links
The Flight Check-in Links REST/JSON API helps simplify the check-in process for your users by providing direct access to the airline’s check-in page. The following search parameters are required:
- Provider code: airline code
- Check-in page language
OpenAPI snippet URL
GET /v1/reference-data/airlines
Summary: Airline Code Lookup
This API returns the airline name and code.
OpenAPI snippet URL
GET /v1/airline/destinations
Summary: Airline Routes
The Amadeus Airline Routes API helps you find all destinations served by a given airline. Provide the IATA code of an airline and the API will retrieve a list of all destination cities along with their names and IATA codes.
This API answers the question:
“What destinations are served by this airline?“
OpenAPI snippet URL
GET /v1/reference-data/locations/pois
Summary: Points of Interest
The Point of Interest API returns a ranked list of popular points of interest. The results are powered by AVUXI TopPlace, which analyzes millions of online reviews, photos and comments and returns a ranked list of popular places including name, latitude and longitude, category, tags and score. The included categories are Sights, Beach/Park, Historical, Nightlife, Restaurant and Shopping. Search locations can be defined by a coordinate with a radius or as an area bound by four coordinates.
OpenAPI snippet URL
GET /v1/reference-data/locations/pois/by-square
Summary: Points of Interest by Square
Returns Points of Interest for a given area.
OpenAPI snippet URL
GET /v1/reference-data/locations/pois/9CB40CB5D0
Summary: Points of Interest by Id
Returns a single Point of Interest from a given id.
OpenAPI snippet URL
GET /v1/shopping/activities
Summary: Tours and Activities
The Tours and Activities API helps you search and book activities, sightseeing tours, day trips and museum tickets in over 8,000 destinations around the world.
OpenAPI snippet URL
GET /v1/shopping/activities/4615
Summary: Tours and Activities by Id
Returns a Tour or Activity given an Id.
OpenAPI snippet URL
GET /v1/shopping/activities/by-square
Summary: Tours and Activities by square
Returns a Tour or Activity given an area.
OpenAPI snippet URL
GET /v1/reference-data/locations/cities
Summary: City Search
City Search
OpenAPI snippet URL
POST /v1/shopping/transfer-offers
Summary: Transfer Search
Handling booking confirmations from different providers can be tricky as there is no standard format used across the industry. The Trip Parser API makes it easy to extract information from different booking confirmation emails and compile it into a single structured JSON itinerary. The API can parse information from flight, hotel, rail and rental car confirmation mails. The API has three endpoints - the first creates a parsing request, the second checks the request status and the third retrieves the parsing results.
OpenAPI snippet URL
POST /v1/ordering/transfer-orders
Summary: Transfer Booking
Handling booking confirmations from different providers can be tricky as there is no standard format used across the industry. The Trip Parser API makes it easy to extract information from different booking confirmation emails and compile it into a single structured JSON itinerary. The API can parse information from flight, hotel, rail and rental car confirmation mails. The API has three endpoints - the first creates a parsing request, the second checks the request status and the third retrieves the parsing results.
OpenAPI snippet URL
POST /v1/ordering/transfer-orders/{transferOrderId}/transfers/cancellation
Summary: Transfer Management
Handling booking confirmations from different providers can be tricky as there is no standard format used across the industry. The Trip Parser API makes it easy to extract information from different booking confirmation emails and compile it into a single structured JSON itinerary. The API can parse information from flight, hotel, rail and rental car confirmation mails. The API has three endpoints - the first creates a parsing request, the second checks the request status and the third retrieves the parsing results.
OpenAPI snippet URL
PARAMETERS /v1/ordering/transfer-orders/{transferOrderId}/transfers/cancellation
OpenAPI snippet URL
GET /v1/travel/analytics/air-traffic/traveled
Summary: Flight Most Traveled Destinations
The Flight Most Traveled Destinations REST/JSON API provides a list of the most popular flight destinations from a given origin during a specific period. This can help answer questions like “Where are most people flying to from Paris during the month of September?“
OpenAPI snippet URL
GET /v1/travel/analytics/air-traffic/booked
Summary: Flight Most Booked Destinations
The Flight Most Booked Destinations REST / JSON API allows to find the most popular flight destinations from an origin during a flight period. This can help answer questions like “Where are most people from Paris, in September, plan to go?“
OpenAPI snippet URL
GET /v1/travel/analytics/air-traffic/busiest-period
Summary: Flight Busiest Traveling Period
The Flight Busiest Traveling Period REST / JSON API allows to find the peak and off-peak travel period for a given city. This can help answer questions like “When is it the cheapest to go to New York?“
OpenAPI snippet URL
GET /v1/location/analytics/category-rated-areas
Summary: Location Score
Help users gain insights into a neighborhood, hotel or vacation rental with the Amadeus Location Score API. For a given latitude and longitude, the Location Score API provides a popularity scores for the following leisure and tourism categories: - Sightseeing - Restaurants - Shopping - Nightlife For each category, the API provides an overall popularity score and scores for select subcategories like luxury shopping, vegetarian restaurants or historical sights, among others. Location scores are on a simple 0-100 scale and are powered by the AVUXI TopPlace algorithm which analyzes millions of online reviews, comments and points of interest.
OpenAPI snippet URL
GET /v1/reference-data/locations/hotels/by-city
Summary: Step 1: Find Hotels by city
Step 1: Find Hotels by city
OpenAPI snippet URL
GET /v3/shopping/hotel-offers
Summary: Step 2: Hotel Offers Search
Search for hotels and retrieve availability and rates information
OpenAPI snippet URL
POST /v1/booking/hotel-bookings
Summary: Step 3: Hotel Booking
The Hotel Booking REST/JSON API is an open API that allows you to book the best hotel offers you have searched from a wide choice of providers.
OpenAPI snippet URL
GET /v1/reference-data/locations/hotels/by-hotels
Summary: Hotel List by Id
Hotel List by Id
OpenAPI snippet URL
GET /v1/reference-data/locations/hotels/by-geocode
Summary: Hotel List by Geocode
Hotel List by Geocode
OpenAPI snippet URL
GET /v3/shopping/hotel-offers/{hotelOfferId}
Summary: Hotel Search Offer Information
Get room and rate details.
OpenAPI snippet URL
PARAMETERS /v3/shopping/hotel-offers/{hotelOfferId}
OpenAPI snippet URL
GET /v2/e-reputation/hotel-sentiments
Summary: Hotel Ratings
This API provides hotel ratings based on automated sentiment analysis algorithm applied on the online reviews
OpenAPI snippet URL
GET /v1/reference-data/locations/hotel
Summary: Hotel Name Autocomplete
The Hotel Name Autocomplete API enables you to autocomplete a hotel search field and help your users quickly find their desired hotel. For a given text string, the API will provide a list of up to 20 hotels whose names most closely match.
OpenAPI snippet URL
POST /v3/travel/trip-parser
Summary: Trip Parser
Handling booking confirmations from different providers can be tricky as there is no standard format used across the industry. The Trip Parser API makes it easy to extract information from different booking confirmation emails and compile it into a single structured JSON itinerary. The API can parse information from flight, hotel, rail and rental car confirmation mails. The API has three endpoints - the first creates a parsing request, the second checks the request status and the third retrieves the parsing results.
OpenAPI snippet URL
GET /v1/travel/predictions/trip-purpose
Summary: Trip Purpose Prediction
It allows developers to forecast traveler purpose, Business or Leisure, together with the probability in the context of search & shopping.
OpenAPI snippet URL