For Agents
Search live flight offers across 500+ airlines and return priced itineraries with full fare breakdown. Supports simple round-trip GET queries and complex multi-city POST searches.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Flight Offers Search, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Flight Offers Search API.
Search round-trip and one-way flight offers across more than 500 airlines
Submit complex multi-city itineraries with passenger mix, cabin class, and connection rules via the POST search
Filter results by maximum price, included or excluded carriers, and non-stop preference
GET STARTED
Use for: I want to find the cheapest flights from London to New York next month, Search for round-trip flight offers between two cities, Find all direct flights from Paris to Tokyo for a given date, Get priced flight itineraries for two adults flying business class
Not supported: Does not handle booking, ticketing, seat selection, or post-booking servicing — use for searching priced flight offers only.
Jentic publishes the only available OpenAPI specification for Flight Offers Search, keeping it validated and agent-ready. The Amadeus Flight Offers Search API returns priced flight itineraries from over 500 airlines on demand. It supports both a GET endpoint for simple round-trip queries and a POST endpoint for complex multi-city, multi-passenger searches with cabin class, fare type, and connection constraints. Travel platforms, online travel agencies, and corporate booking tools use it to power live flight search experiences with real availability and fares.
Return priced offers with detailed fare rules, baggage allowances, and segment breakdowns
Power live shopping flows where pricing must reflect current airline inventory at request time
Patterns agents use Flight Offers Search API for, with concrete tasks.
★ Online Travel Agency Flight Search
Online travel agencies use the Flight Offers Search API to power their live flight search results pages. The GET /shopping/flight-offers endpoint takes origin, destination, dates, and passenger counts, returning priced itineraries directly from airline inventory. Most queries return a complete results set in under three seconds, fast enough to render a search results page without an interim spinner.
Call GET /shopping/flight-offers with originLocationCode=LON, destinationLocationCode=NYC, departureDate=2026-08-15, returnDate=2026-08-22, adults=2, currencyCode=GBP and render the top 10 priced offers
Corporate Travel Booking Tool
Corporate travel platforms use the POST /shopping/flight-offers endpoint to enforce travel policy constraints when employees search for flights. The POST body accepts a structured search request with origin-destination pairs, passenger types, and a list of allowed or forbidden carriers, plus cabin restrictions. The platform then surfaces only policy-compliant fares for booking approval.
POST /shopping/flight-offers with a structured search including originDestinations, travelers list, and a searchCriteria block restricting cabin to BUSINESS and excluding two specified carriers
Price Monitoring and Fare Alerts
Fare-watch services poll the Flight Offers Search API on a schedule to track prices on watched city pairs and alert users when fares drop below a threshold. The maxPrice query parameter on the GET endpoint lets the service request only offers under a target price, reducing payload size and post-processing.
Call GET /shopping/flight-offers daily for LHR to JFK with maxPrice=400 and notify the user when at least one offer is returned
AI Travel Agent Itinerary Builder
An AI travel-planning agent invoked through Jentic uses Flight Offers Search to assemble itineraries from a natural-language request. The agent searches Jentic for the flight-offers operation, loads its schema, executes the POST endpoint with the parsed travel requirements, and presents priced options back to the user. Authentication and OAuth token refresh are handled by Jentic, so the agent only deals with the structured search request and response.
Search Jentic for search flight offers, load the POST flight-offers operation schema, execute it with the parsed user request, and return the cheapest three priced itineraries
2 endpoints — jentic publishes the only available openapi specification for flight offers search, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/shopping/flight-offers
Search flight offers using query parameters for simple round-trip and one-way queries
/shopping/flight-offers
Search flight offers with a structured request body for complex multi-city itineraries
/shopping/flight-offers
Search flight offers using query parameters for simple round-trip and one-way queries
/shopping/flight-offers
Search flight offers with a structured request body for complex multi-city itineraries
Three things that make agents converge on Jentic-routed access.
Credential isolation
Amadeus client_id and client_secret are stored encrypted in the Jentic vault. Jentic performs the OAuth 2.0 token exchange server side and refreshes tokens automatically, so the agent only sees a scoped session — never the raw Amadeus secret.
Intent-based discovery
Agents search Jentic with phrases like search flight offers or find round-trip flights, and Jentic returns the GET or POST flight-offers operation with its input schema, so the agent can call it without browsing Amadeus Self-Service docs.
Time to first call
Direct integration: 3 to 5 days including OAuth handling, parameter mapping for the structured POST body, and quota management. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Flight Offers Search API through Jentic.
Why is there no official OpenAPI spec for Flight Offers Search?
Amadeus does not publish a single OpenAPI specification for Flight Offers Search. Jentic generates and maintains this spec so that AI agents and developers can call Flight Offers Search via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Flight Offers Search API use?
The API uses OAuth 2.0 client-credentials. You exchange an Amadeus client_id and client_secret for a short-lived bearer token at the Amadeus auth endpoint, then send it as Authorization: Bearer on each /shopping/flight-offers request. Through Jentic, the client_id and client_secret are stored encrypted in the vault and the token exchange is performed server side.
Can I search multi-city itineraries with the Flight Offers Search API?
Yes. Use POST /shopping/flight-offers with a structured request body containing multiple originDestinations entries. Each entry has its own origin, destination, and date, which lets you build itineraries with three or more legs in a single call. The GET endpoint only supports round-trip and one-way.
What are the rate limits for the Flight Offers Search API?
The Amadeus Self-Service test environment limits Flight Offers Search to 10 transactions per second per application, with monthly transaction caps depending on your tier. Production limits are negotiated per Amadeus contract. Treat 429 responses as a signal to back off and retry with exponential delay.
How do I search flights with the Flight Offers Search API through Jentic?
Install the SDK with pip install jentic, then search Jentic for search flight offers, load the operation schema, and execute either the GET or POST flight-offers operation with the user's travel parameters. Jentic handles OAuth token exchange and refresh, so the agent only deals with the search request and response.
Are the prices returned by the Flight Offers Search API guaranteed?
No. Prices reflect real-time airline inventory at the moment of the search and can change before booking. To confirm a price, call the Flight Offers Price endpoint with the selected offer before proceeding to booking; only the price returned by that confirmation step is bookable.