Getting Started

1. Go to 🔗developers.amadeus.com and click on Register

2. Verify your account and Sign in

3. Go to My Self-Service Workspace and Create a new app

4. Get you API Key and the API Secret linked to your app

5. Request an access token (see Requesting an access token)

6. Call all the APIs by adding the header:

   Authorization: Bearer access_token

Requesting access token

Request

1. Send a POST request to:

   https://test.api.amadeus.com/v1/security/oauth2/token

2. Adding the header:

   Content-Type: application/x-www-form-urlencoded

3. And then the body:

   grant_type=client_credentials&client_id=API_Key&client_secret=API_Secret

Response

1. The response will be the access token

   access_token

   Note: valid for only 30 minutes

Libraries on GitHub

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/70bd0d3d-f3ba-4cda-8047-b1197fb529ab/node.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/70bd0d3d-f3ba-4cda-8047-b1197fb529ab/node.png" width="40px" /> Node

</aside>

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/61cba18d-f5a7-48c0-8352-1acfc5ba4b7b/java.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/61cba18d-f5a7-48c0-8352-1acfc5ba4b7b/java.png" width="40px" /> Java

</aside>

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/89d9a42b-83e4-4054-9884-f68b58702e72/python.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/89d9a42b-83e4-4054-9884-f68b58702e72/python.png" width="40px" /> Python

</aside>

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/f6848bd2-30fa-413f-8119-187bfd8e3715/developers_2.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/f6848bd2-30fa-413f-8119-187bfd8e3715/developers_2.png" width="40px" /> **API BASE URL

https://test.api.amadeus.com**

</aside>

Flights

Get rich flight information for inspiration, search and booking.

Flight Booking ****

• Flight Offers Search: Search flight offers
• Flight Offers Price: Validate flight offer
• Flight Create Orders: Book flight offer
• Flight Order Management: Retrieve/Cancel flight order
• SeatMap Display: Retrieve seat map for flight order/offer
• Branded Fares Upsell: Find available branded fares
• Flight Choice Prediction: Find booking probability score
• Flight Price Analysis: Retrieve flight price analysis

Flight Inspiration

• Flight Inspiration Search: Find cheapest flight destinations
• Flight Cheapest Date Search: Find cheapest flight dates
• Flight Availabilities Search: Find fare class availability ****
• Travel Recommendations: Find destination recommendations

Flight Schedule

• On-Demand Flight Status: Retrieve flight status
• Flight Delay Prediction: Retrieve chance of flight delay
• Airport On-Time Performance: Retrieve chance of airport delay

Airport ****

• Airport & City Search: Find/Retrieve airports or cities
• Airport Nearest Relevant: Find nearest airports
• Airport Routes: Find all destinations served by a given airport

Airlines

• Flight Check-in Links: Retrieve URL to check-in
• Airline Code Lookup: Find airline information
• Airline Routes: Find all destinations served by a given airline

Hotels

Search and book hotels from a wide range of top providers.

• Hotel List: Find list of hotels inside a city or an area

• Hotel Search: Search/Retrieve hotel offer & Retrieve hotel and room information

• Hotel Booking: Book hotel offer

• Hotel Ratings: Find hotel ratings

• Hotel Name Autocomplete: autocomplete a hotel search field

Cars and Transfers

Search and book private transfers

• Transfer Search: Find transfers offers at a pickup location and time
• Transfer Booking: Performs transfer reservation