Amadeus
Amadeus for Developers is the self-service developer program from Amadeus IT Group, the leading technology provider for the global travel and tourism industry. The Self-Service catalog offers 40+ travel REST APIs across flights, hotels, destination experiences, cars and transfers, market insights, itinerary management, and AI-powered prediction services. APIs use OAuth2 client credentials authentication and are organized into Test (free, capped) and Production (paid, higher TPS) environments. Note: Amadeus has announced the Self-Service developer portal will be decommissioned on 17 July 2026; Enterprise customers retain access to the equivalent Enterprise APIs.
APIs
Flight Offers Search
Searches over 500 airlines to find the cheapest flight offers for a given itinerary. Supports one-way, round-trip, and multi-city searches with rich filtering (cabin class, max ...
Flight Offers Price
Confirms the final price and availability of a flight offer returned by Flight Offers Search, including taxes, fees, and fare rules, before booking.
Flight Create Orders
Books a flight offer by creating a flight order (PNR) with traveler details, contact info, and payment, returning the order ID and ticketing reference.
Flight Order Management
Retrieves and cancels existing flight orders. Use after Flight Create Orders to view PNR details or cancel a booking.
Flight Availabilities Search
Searches real-time flight availability and inventory between origin and destination for a given date, returning bookable flight segments with classes of service.
SeatMap Display
Returns the seat map for a specific flight, including available, occupied, and reserved seats with characteristics (window, aisle, exit row, extra legroom).
Branded Fares Upsell
Returns branded fares (e.g. Economy Light, Economy Flex, Business Lite) and their attributes for a given flight offer to surface upsell options to travelers.
Flight Check-in Links
Returns direct check-in URLs for a given airline (IATA code) and language, deep-linking travelers into the carrier's check-in flow.
On Demand Flight Status
Returns the real-time status (scheduled, delayed, departed, landed) and detailed itinerary of a specific flight on a specific date.
Flight Inspiration Search
Suggests cheap destinations from a given origin within a budget and date range, ideal for "where can I go for X dollars?" experiences.
Flight Cheapest Date Search
Returns the cheapest dates to fly between two cities over a given date range to help travelers find the best fare windows.
Flight Price Analysis
Compares a current flight price to historical prices for the same route and returns a quartile-ranked "price metric" (FIRST, SECOND, THIRD, FOURTH) signalling whether the offer ...
Flight Choice Prediction
Predicts the probability that a given flight offer will be chosen by a traveler, helping merchandising and ranking decisions.
Flight Delay Prediction
Predicts the probability that a flight will be delayed by 30 minutes, 60 minutes, 120 minutes, or more, based on historical operational data.
Airport On-Time Performance
Returns the on-time performance score for an airport on a specific date, useful for operational and route planning analytics.
Airport Routes
Returns all destinations served from a given origin airport, with carriers operating each route.
Airline Routes
Returns all routes operated by a given airline (IATA code), enabling network and competitive analysis.
Airport Nearest Relevant
Returns the most relevant nearby airports for a given latitude/longitude, ranked by traffic volume.
Airport and City Search
Searches airports and cities by keyword and returns IATA codes, names, geocoordinates, and country information. Backbone of any travel search UI autocomplete.
City Search
Searches cities matching a keyword, returning city codes, country, geocoordinates, and timezone. Useful for destination and itinerary planning.
Airline Code Lookup
Returns the airline name and details for a given IATA or ICAO airline code, used for translating codes into traveler-facing names.
Flight Most Booked Destinations
Returns the most booked destinations from a given origin city for a given period, surfacing demand patterns for marketing and merchandising.
Flight Most Traveled Destinations
Returns the most traveled-to destinations from a given origin city for a given period, useful for trend analysis and inspiration UIs.
Flight Busiest Traveling Period
Returns the busiest travel periods (months) for a given city, helping with capacity planning and pricing strategy.
Hotel List
Returns the list of hotels in a given city, geographic area, or by hotel IDs, with property metadata. The foundation lookup for downstream hotel offers and ratings calls.
Hotel Search
Returns available hotel offers (rates, room types, board, cancellation policies) for a list of hotel IDs and a stay date range.
Hotel Booking
Creates a hotel booking (reservation) from a confirmed offer, including guest information, payment, and contact details.
Hotel Name Autocomplete
Returns up to 20 hotels whose names match a search keyword, with full address, geocode, property type, IATA hotel code, and Amadeus hotel ID — ideal for search-as-you-type hotel...
Hotel Ratings
Returns sentiment-analyzed ratings for hotels across categories like service, room, location, and food, derived from millions of online reviews.
Points of Interest
Returns points of interest (sights, restaurants, nightlife, shopping) for a given location with categories and rankings.
Tours and Activities
Returns bookable tours, activities, and experiences for a given location with prices, photos, and provider details.
Safe Place
Returns a safety score for a location across categories like LGBTQ+, women, physical harm, and theft, helping travelers make informed destination decisions.
Location Score
Returns a 0-100 score for a location across categories (sights, restaurants, shopping, nightlife, historical, beach/park), powering destination ranking experiences.
Travel Recommendations
Returns destination recommendations based on a list of seed cities and traveler country, powering "if you liked X you'll like Y" discovery experiences.
Trip Purpose Prediction
Predicts whether a trip is for business or leisure based on the itinerary's origin, destination, dates, and search timing, helping route trip-specific merchandising.
Transfer Search
Searches private and shared transfer options (taxi, limo, shuttle) between two locations with prices, vehicle types, and cancellation policies.
Transfer Book
Books a transfer based on the offer returned by Transfer Search, capturing passenger details, pickup, and payment.
Transfer Management
Cancels an existing transfer booking and manages the transfer order lifecycle.
Authorization
OAuth2 client credentials token endpoint used by every Self-Service API. Exchanges API key + secret for a short-lived bearer access token (~30 minute TTL).
Features
Comprehensive catalog spanning flights, hotels, destination experiences, cars and transfers, market insights, itinerary management, and AI-powered prediction.
Server-to-server authentication with short-lived bearer tokens (~30 min TTL) on a single token endpoint shared by all APIs.
Free, cached test environment for development; production environment for live data with pay-as-you-go billing above monthly free tiers.
Official SDKs for Node.js, Python, Java, and Ruby with built-in token management, retries, and pagination.
Trip Purpose, Flight Choice, Flight Delay, Price Analysis, Travel Recommendations, and Location Score APIs powered by machine learning over Amadeus travel data.
Hotel ratings derived from millions of online reviews, broken down by service, room, location, and food.
Branded Fares Upsell and SeatMap Display surface merchandising opportunities at search and booking time.
Most booked destinations, most traveled destinations, and busiest travel periods power demand and trend analytics.
Curated Postman collection with examples for every Self-Service API, maintained by the amadeus4dev team.
Canonical Swagger/OpenAPI specs published on GitHub at amadeus4dev/amadeus-open-api-specification.
Use Cases
Build a full flight + hotel + activities OTA using Flight Offers Search, Hotel Search, Tours and Activities, Transfer Search, and the corresponding booking APIs.
Combine Flight Offers Search, Trip Purpose Prediction, and Hotel Search to deliver policy-aware corporate booking flows.
Use Flight Inspiration Search, Flight Cheapest Date Search, Travel Recommendations, and Location Score to inspire destination choices.
Use On-Demand Flight Status, Airport On-Time Performance, and Flight Delay Prediction to build proactive disruption-aware traveler experiences.
Combine Hotel Search, Hotel Ratings, and Points of Interest to merchandise hotels with location context and review sentiment.
Use Tours and Activities, Points of Interest, Safe Place, and Location Score to power destination marketing organization (DMO) experiences.
Use the Market Insights APIs (Most Booked, Most Traveled, Busiest Period) for demand and trend dashboards.
Use Transfer Search, Transfer Book, and Transfer Management to add airport-to-hotel ground transport to an itinerary.
Use the free Test environment, official SDKs, and amadeus4dev sample apps to ship a travel MVP in days.
Wrap Self-Service APIs in MCP servers (community implementations exist) to give LLM agents flight, hotel, and activity search and booking capabilities.
Integrations
Official Amadeus for Developers public workspace with collections for every Self-Service API.
Official npm package `amadeus` with built-in OAuth handling.
Official PyPI package `amadeus` with built-in OAuth handling and pagination.
Official Maven Central artifact `com.amadeus:amadeus-java`.
Official Ruby SDK at github.com/amadeus4dev/amadeus-ruby.
Multiple sample Django apps demonstrating flight booking, hotel booking, and tours integration.
Several community MCP servers expose Amadeus Self-Service APIs as tools for Claude and other LLM agents.
Community example using the Bottleneck rate-limiter to manage Amadeus TPS quotas in Node.js apps.
Solutions
Self-service catalog of 40+ REST APIs with free Test environment and pay-as-you-go Production environment. NOTE: scheduled for decommissioning 17 July 2026.
Enterprise developer portal and SLA-backed access to the full Amadeus distribution, ticketing, and operations APIs, including NDC content and Margins/Discounts not available in Self-Service.
The underlying global distribution and travel technology platform powering airlines, hotels, ground transport, and travel agencies worldwide.