canonical: https://jentic.com/apis/amadeus.com/amadeus-flight-availabilities-search

# Amadeus Flight Availabilities Search

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.

## For AI 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.

## Scope

Does not return priced fares, branded fare tiers, or bookable offers - use only for raw per-class seat availability on a set of segments.

## Capabilities

- 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
- Drive multi-segment ticket construction by confirming class capacity end to end
- Support travel-agency workflows that need class inventory before issuing a ticket

## Use cases

### 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.

Example prompt: 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.

Example prompt: 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.

Example prompt: 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.

Example prompt: 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

| Method | Path | Description |
| --- | --- | --- |
| POST | /shopping/availability/flight-availabilities | Get per-class seat availability for flight segments |

## Key resources

- **Flight Availabilities** — POST origin-destination pairs and receive per-class seat counts for each segment.

## Why Jentic

- **Setup:** Wiring the Flight Availabilities Search API by hand means running the Amadeus OAuth 2.0 client_credentials exchange, refreshing the bearer token, building the segment request body for POST /shopping/availability/flight-availabilities, and parsing per-class RBD responses against the correct host and version. Through Jentic you install once, import Flight Availabilities Search from the API Directory, store the Amadeus client credentials once, and your agent calls it.
- **Permission scoping:** The segments to check travel in the request body rather than as a resource id in the URL path, so scoping is by operation. You limit the agent to the operations it needs, such as reading per-class seat availability, and it cannot reach priced-offer or booking operations unless you add them.
- **Credential handling:** 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.
- **Discovery method:** Agents search Jentic by intent such as 'check per-class seat availability for these flight segments', and Jentic returns the /shopping/availability/flight-availabilities operation with its input schema so the agent posts the segments and reads availability without reading the Amadeus reference docs.

## Related APIs

- **Amadeus Flight Cheapest Date Search** — Returns cheapest priced dates rather than per-class availability.
- **Amadeus Flight Offers Price** — Prices a constructed offer once availability has confirmed it is bookable.
- **Amadeus Branded Fares Upsell** — Expands a confirmed offer into its branded fare families.

## FAQ

### 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.

### Can I limit what my agent is allowed to do with the Amadeus Flight Availabilities Search API?

Yes. Because you run Jentic One yourself and set your own rules, you decide which operations and credentials the agent may use. This API scopes by operation rather than by a resource id in the URL, since the segments to check travel in the request body, so you can allow only the flight-availabilities read that returns per-class seat counts. The agent cannot reach priced-offer or booking operations unless you explicitly add them.