Search for flight offers using the Amadeus Self-Service API

domain: amadeus · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Obtain an access token by POSTing your client_id and client_secret to https://test.api.amadeus.com/v1/security/oauth2/token with grant_type=client_credentials; the response contains a bearer token valid for 1799 seconds.
  2. Call GET /v2/shopping/flight-offers with required params: originLocationCode (IATA), destinationLocationCode (IATA), departureDate (YYYY-MM-DD), adults (integer); optionally add returnDate, travelClass, max (result count cap).
  3. Parse the response: each element in data[] is a FlightOffer object with a unique id, price.grandTotal (currency in price.currency), itineraries[], and validatingAirlineCodes[].
  4. Note the lastTicketingDate field on each offer — this is the deadline by which the ticket must be issued, not just held.
  5. Filter or rank offers in your application logic; do not assume ordering is by price — sort explicitly on price.grandTotal if needed.
  6. Before displaying to a user, store the full offer object verbatim; you will need to pass it back unchanged in the pricing and order-creation calls.

Known gotchas

Related routes

Complete a search-to-order flight booking using the Amadeus Self-Service API with seat selection
developers.amadeus.com · 5 steps · unrated
Price a flight offer and create a confirmed order in Amadeus
amadeus · 6 steps · unrated
Search and book ground transfers using the Amadeus Transfer Offers API
developers.amadeus.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans