Install Jentic One Beta

Connect the Flight Availabilities Search to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Flight Availabilities 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://jentic.com/install.sh?src=apis&api=%2Fapis%2Famadeus.com%2Famadeus-flight-availabilities-search" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Famadeus.com%2Famadeus-flight-availabilities-search" | 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 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

GET STARTED

Start building with Flight Availabilities Search API

Explore with Jentic One

View OpenAPI Document

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 Jentic?

What agents get from Jentic-routed access to this vendor.

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

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.

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.

Amadeus Flight Availabilities Search

Browse all Amadeus APIs

Official vendor OpenAPI document · agent-readyE 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.

Use for: I want to check how many Y-class seats are available on a specific flight, Find availability for two origin-destination pairs in one request, Search class inventory for the user's preferred carrier on a chosen date, Get the seat counts per booking class for a JFK to LHR segment

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

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.

Jentic One on Github View OpenAPI Document