Amadeus for Developers API

Transportation / OAuth Advanced HTTPS
Varies by plan (check documentation)

Overview

Amadeus for Developers is an OAuth2-protected travel API offering flight search, hotel availability, airport information, and more from one of the largest global distribution systems. The self-service tier is free with usage limits and is designed for developers building travel apps. You will need to register for a client ID and secret, then exchange them for an access token before making data requests.

💡

Beginner Tip

Always request a fresh access token using the client_credentials grant before your API calls as tokens expire after 30 minutes. Use the test environment with test credentials to avoid consuming your production quota while learning.

Available Data

Use case: Integrate travel search - limited usage data into web and mobile applications
Amadeus for Developers data via REST API
JSON-formatted response data
Requires OAuth authentication

Example Response

JSON Response
{
  "route": "Line 1",
  "origin": "Station A",
  "destination": "Station B",
  "departure": "08:30",
  "arrival": "09:15",
  "status": "On Time",
  "delays_min": 0
}

Field Reference

type Resource type, typically flight-offer for search results.
id Unique identifier for the flight offer used for booking steps.
price.total Total price including taxes formatted as a decimal string.
itineraries List of itinerary legs each containing segment-level departure and arrival details.
validatingAirlineCodes IATA codes of airlines responsible for ticket issuance.

Implementation Example

const url = "https://developers.amadeus.com/self-service";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized Access token is missing, expired, or was generated in the wrong environment.
Request a new token via POST /v1/security/oauth2/token; tokens expire after 1799 seconds.
400 Bad Request on flight search Date format is incorrect or origin and destination codes are invalid IATA codes.
Use ISO 8601 date format YYYY-MM-DD and valid three-letter IATA airport codes such as JFK or LHR.
No results returned No flights match the search criteria in the test dataset.
The test environment uses a limited dataset; try popular routes such as MAD to NYC with future dates for reliable test results.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 5/20
🔒 Security 15/15
🛠 Developer XP 3/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth OAuth
HTTPS REQUIRED
CORS UNKNOWN
Category Transportation
Difficulty Advanced
Verified: 2026-04-04

Similar APIs

View All →