Flight Availabilities Search

✓ Official Vendor SpecE CommerceStorefrontoauth21 EndpointsREST

For Agents

Get bookable seat counts per booking class for flight segments. Agents POST to /shopping/availability/flight-availabilities to check class-by-class capacity before constructing a ticket.

Quickstart

Get started with Flight Availabilities Search in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"check seat availability per booking class"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Flight Availabilities Search API.

Return seat counts per Reservation Booking Designator for each flight segment

Search availability across multiple origin-destination pairs in one request

Filter by carrier or alliance to constrain the result set

Surface raw GDS-style availability that fare search alone does not expose

GET STARTED

Start building with Flight Availabilities Search API

Explore with Jentic

View OpenAPI Document

The Amadeus Flight Availabilities Search API returns seat availability per booking class for one or more origin-destination pairs and dates. The single POST to /shopping/availability/flight-availabilities is closer to a GDS availability call than to a fare search — it gives the number of bookable seats per Reservation Booking Designator on each flight segment, which is what travel agencies and OTAs need to construct multi-segment tickets without overselling. Use this when a fare-only search is not enough and you need raw availability per cabin class.

Use Cases

Patterns agents use Flight Availabilities Search API for, with concrete tasks.

★ Travel Agency Ticket Construction

Agencies issuing complex itineraries need raw availability per booking class on each segment, not just a list of fare offers. The /shopping/availability/flight-availabilities endpoint returns the number of seats open in each Reservation Booking Designator, which lets the agent assemble a multi-segment ticket that will actually price and book without surprise sold-out errors at confirmation.

POST a request for JFK to LHR on 2026-09-15 plus LHR to BCN on 2026-09-18 and return the seat counts per booking class for each leg.

Group Travel Capacity Check

When booking a group of 8 travellers in a specific cabin class, a fare-search response that simply says 'available' is not enough — you need at least 8 seats open in the same RBD. Calling Flight Availabilities Search confirms the class-level capacity before the group sales agent commits, removing the back-and-forth that happens when the priced offer fails at the booking step.

Confirm at least 8 seats are open in J class on the LH segment between FRA and JFK for the group's travel date.

Fare Construction with Class Control

Sophisticated travel sellers construct fares manually by selecting booking classes that price together favourably. Flight Availabilities Search exposes those classes directly, so a pricing engine can pick the right class per segment instead of relying on whatever class the public Flight Offers Search returns.

Identify the lowest open RBD for each segment in the proposed itinerary and construct a fare around those classes.

Agent-Driven Availability Audit

An AI agent supporting a travel desk can answer 'is there a J seat on flight LH 400 next Tuesday?' by calling availability search directly. Through Jentic the agent searches for 'check seat availability per booking class', loads the schema, runs the POST, and returns a yes/no answer with the exact seat count from the response.

Use Jentic to call the flight-availabilities operation and report whether at least one J-class seat is open on the user's chosen flight.

Key Endpoints

1 endpoints — the amadeus flight availabilities search api returns seat availability per booking class for one or more origin-destination pairs and dates.

METHOD

PATH

DESCRIPTION

POST

/shopping/availability/flight-availabilities

Get per-class seat availability for flight segments

POST

/shopping/availability/flight-availabilities

Get per-class seat availability for flight segments

Why though 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 'check seat availability per booking class' and Jentic returns the /shopping/availability/flight-availabilities operation with its input schema, removing the need to read Amadeus self-service docs first.

Time to first call

Direct Amadeus integration: 1-2 days to wire OAuth, build the request shape, and parse RBD responses. Through Jentic: under one hour — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Amadeus Flight Cheapest Date Search

Returns cheapest priced dates rather than per-class availability.

Choose this when the agent only needs prices on flexible dates; use availability search when you need class-by-class capacity.

Complementary

Amadeus Flight Offers Price

Prices a constructed offer once availability has confirmed it is bookable.

Call after availability confirmation to lock in the fare for the selected classes.

Complementary

Amadeus Branded Fares Upsell

Expands a confirmed offer into its branded fare families.

Use after availability and pricing once the user has chosen a flight; expose upsell tiers for that offer.

FAQs

Specific to using Flight Availabilities Search API through Jentic.

What authentication does the Flight Availabilities 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/availability/flight-availabilities POST. Jentic stores the credentials in the encrypted vault and refreshes the token automatically.

How is this different from Flight Offers Search?

Flight Offers Search returns priced offers with a publicly bookable fare. Flight Availabilities Search returns raw per-class seat counts (per Reservation Booking Designator) for the segments you specify, without pricing them. Use the availability call when you need to confirm class capacity before constructing a ticket.

What are the rate limits for the Flight Availabilities Search API?

Rate limits are not declared in the OpenAPI spec and depend on the Amadeus contract tier. Availability calls are heavier than reference-data lookups, so expect a tighter per-second cap and use targeted queries rather than scanning a whole calendar of dates.

How do I check class-level availability through Jentic?

Run pip install jentic, then use the search query 'check seat availability per booking class'. Jentic returns the /shopping/availability/flight-availabilities operation, you load the schema, supply origin, destination, date, and traveller counts, and execute. The response gives RBD seat counts per segment.

Can I search availability across multiple legs in one call?

Yes. The request body accepts an array of originDestinations so a single POST can return availability for an outbound and a return, or for a multi-segment itinerary. Each leg's RBDs are returned independently.

Is the Flight Availabilities Search API free?

Amadeus self-service APIs include a free test environment with quota limits and a paid production tier. Availability calls in production are contracted and pricing scales with transaction volume — confirm current rates in the Amadeus self-service developer portal.