Amadeus Flight Cheapest Date Search
Browse all Amadeus APIs✓ Official Vendor SpecE CommerceStorefrontoauth21 EndpointsREST
For Agents
Return the cheapest dates to fly between two cities for a flexible date range. Agents call /shopping/flight-dates to power flexible-date calendar widgets.
Use for: I want to find the cheapest dates to fly from London to New York, Search for the lowest fare between MAD and BCN over the next 90 days, Get the cheapest day to fly from Paris to Tokyo this autumn, List the cheapest one-way dates from JFK to LAX
Not supported: Does not return per-class availability, branded fare tiers, or bookable priced offers — use only for cheapest-date inspiration between two cities.
The Amadeus Flight Cheapest Date Search API returns the cheapest available dates to fly between two cities, ranked by total fare. The single GET endpoint at /shopping/flight-dates accepts an origin, destination, and a flexible date range and returns price points keyed by date pair, which is what powers 'when is it cheapest?' calendar widgets and flexible-date search experiences. It is intended for inspirational and flexible-date searches rather than precise booking flows.
Install Jentic One Beta
Connect the Flight Cheapest Date Search to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Flight Cheapest Date 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.
1
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 | sh2
Step 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.
Capabilities
What an agent can do with Flight Cheapest Date Search API.
Return the cheapest fares for date pairs between two cities over a flexible window
Filter by one-way or round-trip via the oneWay query parameter
Constrain results by maximum price ceiling for budget-aware searches
Surface enough date variation to build a fare calendar widget
Power 'flexible dates' toggles in flight search UIs without a full Flight Offers Search per date
Identify the lowest-priced travel window in a month for inspiration content
Use Cases
Patterns agents use Flight Cheapest Date Search API for, with concrete tasks.
★ Flexible-Date Calendar Widget
Travel sites compete on showing 'cheapest day to fly' calendars. The /shopping/flight-dates endpoint returns priced date pairs in one call, which is enough to colour a calendar by price band without firing a separate flight offer search per date. The endpoint is purpose-built for inspiration rather than booking, so it is much cheaper to call than full availability.
Call /shopping/flight-dates with origin=LON, destination=NYC, oneWay=false and return all date pairs sorted by total fare ascending.
Budget-Capped Inspiration
A 'where can I go for under £100?' page can pin the destination and use Cheapest Date Search with a maximum price ceiling, returning only the date windows that fit the budget. This is faster and cheaper than running flight offer searches for every candidate date and trimming the response client-side.
Search /shopping/flight-dates with maxPrice=100 between LON and DUB and return all dates that come back within budget.
Newsletter Deal Finding
Editorial newsletters that surface flight deals can run a nightly batch of cheapest-date searches across a watch list of routes. Each route returns a sorted list of cheapest date pairs, so the newsletter can publish 'the lowest London-to-Lisbon fare this week is £42 on Tuesday-Friday'. The single-endpoint design keeps the batch lightweight.
Run /shopping/flight-dates for a watch list of 30 routes nightly and surface the lowest fare per route into the newsletter draft.
Agent Trip Planner
An AI travel agent given 'I'm flexible — when is it cheapest to fly home?' can call Cheapest Date Search with the user's origin, destination, and a window. Through Jentic the agent searches for 'find the cheapest dates to fly between two cities', loads the schema, executes, and answers in plain language with the lowest fare and its travel dates.
Use Jentic to call cheapest-date search for the user's flexible window and answer with the lowest fare and its travel dates.
Key Endpoints
1 endpoints — the amadeus flight cheapest date search api returns the cheapest available dates to fly between two cities, ranked by total fare.
METHOD
PATH
DESCRIPTION
GET
/shopping/flight-dates
Return cheapest dates between two cities
GET
/shopping/flight-dates
Return cheapest dates between two cities
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Amadeus client credentials are stored encrypted in the Jentic vault (MAXsystem). Jentic exchanges them for a short-lived bearer token at execution time so the raw secret never enters agent context.
Intent-based discovery
Agents search Jentic for 'find the cheapest dates to fly between two cities' and Jentic returns the /shopping/flight-dates operation with its input schema, removing the need to read Amadeus self-service docs first.
Time to first call
Direct Amadeus integration: half a day to wire OAuth and parse the priced date pairs into a calendar widget. Through Jentic: under fifteen minutes — search, load, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Flight Cheapest Date Search API through Jentic.
What authentication does the Flight Cheapest Date Search API use?
The API uses the Amadeus OAuth 2.0 client-credentials flow. Exchange API key and secret at the Amadeus token endpoint and send the bearer token on the /shopping/flight-dates request. Jentic stores the credentials in the encrypted vault and refreshes the token automatically.
Are the returned fares bookable?
The endpoint is intended for inspirational and flexible-date searches; the prices indicate the lowest fares Amadeus has seen for those date pairs. To book, follow up with a Flight Offers Search and Flight Offers Price call against the chosen date pair to confirm the fare is still bookable.
What are the rate limits for the Flight Cheapest Date Search API?
Rate limits are not declared in the OpenAPI spec and depend on the Amadeus contract tier. The call returns many date pairs in a single response, which makes it cheaper than calling Flight Offers Search per date — still cache responses keyed on origin, destination, and window to stay under the per-second cap.
How do I find the cheapest date through Jentic?
Run pip install jentic, then use the search query 'find the cheapest dates to fly between two cities'. Jentic returns the /shopping/flight-dates operation, you load the schema, supply origin, destination, and oneWay, and execute. The response gives the cheapest date pairs ready to render in a calendar widget.
Can I cap results to a maximum fare?
Yes. Pass maxPrice on the request to limit results to date pairs that fall under the supplied amount. This is the right way to power 'where can I go for under £100?' style inspiration pages.
Is the Flight Cheapest Date Search API free?
Amadeus self-service APIs include a free test environment with quota limits and a paid production tier. Production pricing depends on transaction volume and is set by contract — confirm current rates in the Amadeus self-service developer portal.
GET STARTED