Amadeus Flight Cheapest Date Search

Name: Flight Cheapest Date Search API
Brand: Flight Cheapest Date Search
Availability: InStock

✓ Official Vendor SpecE CommerceStorefrontoauth21 Endpoints

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.

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 | sh

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 instance

Jentic 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

GET STARTED

Start building with Flight Cheapest Date Search API

Explore with Jentic

View OpenAPI Document

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.

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

Your Amadeus client_id and client_secret are stored once, encrypted, by your own Jentic One instance, which runs the client_credentials exchange and injects a fresh bearer token at execution time. The raw secret never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'find the cheapest dates to fly from London to Rome', and Jentic returns the /shopping/flight-dates operation with its input schema so the agent supplies the two cities and reads the date pairs without reading the Amadeus docs first.

Time to first call

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.

Can I limit what my agent is allowed to do with the Flight Cheapest Date Search API?

Yes. This API exposes a single operation, GET /shopping/flight-dates, which reads the cheapest date pairs between two cities, so with your self-hosted Jentic One instance you decide which operations your agent may call and scope it to just cheapest-date reads. Because the origin and destination travel as query parameters rather than as a resource id in the URL path, scoping is by operation: the agent cannot reach availability, pricing, or booking operations unless you explicitly add them under your own rules. Your Amadeus client credentials are held by your Jentic One instance and injected at execution time, so the agent runs the calls you permit without ever seeing the raw secret.