Amadeus Branded Fares Upsell

Name: Branded Fares Upsell API
Brand: Branded Fares Upsell
Availability: InStock

✓ Official Vendor SpecE CommerceStorefrontoauth21 EndpointsREST

Install Jentic One Beta

Connect the Branded Fares Upsell to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Branded Fares Upsell, 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 Branded Fares Upsell API.

Return branded fare families for an existing flight offer in a single POST

Surface included services per fare such as checked bags, seat selection, and changes

Show price deltas between basic and higher branded tiers for the same itinerary

GET STARTED

Start building with Branded Fares Upsell API

Explore with Jentic

View OpenAPI Document

For Agents

Return branded fare families for a flight offer with included services and price deltas. Agents POST a flight offer to /shopping/flight-offers/upselling to surface upgrade tiers.

Use for: I want to show branded fare options for a Lufthansa flight offer, Find all upsell tiers available for this flight offer, Get the price difference between Economy Light and Economy Flex for an itinerary, Retrieve the included services for each branded fare family

Not supported: Does not search flights, price offers, or create bookings - use only to expand an existing flight offer into its branded fare families.

Use Cases

Patterns agents use Branded Fares Upsell API for, with concrete tasks.

★ Side-by-Side Fare Comparison

Replace the airline.com 'choose your fare' page in a third-party booking tool by sending the selected flight offer to /shopping/flight-offers/upselling. The response contains every branded fare family the carrier offers for that itinerary - Economy Light through Business Flex - with included bags, seat selection rights, and price deltas, ready to render in a comparison panel.

POST a Lufthansa flight offer to /shopping/flight-offers/upselling and return all branded fare options with their included services and price deltas.

Corporate Travel Policy Enforcement

Corporate booking tools enforce policy by selecting a specific branded tier - for example, only fares that include a checked bag and free changes. The upsell endpoint returns enough metadata per tier to filter out non-compliant fares before they reach the traveller, reducing the number of out-of-policy bookings that need exception handling.

Filter the upsell response down to fares that include both a checked bag and free changes and surface the cheapest compliant tier.

Ancillary Revenue Optimisation

Travel resellers can lift ancillary revenue by presenting the upsell tiers prominently rather than defaulting to the cheapest fare. The branded fare response includes the price delta and the tangible included services per tier, which is enough to highlight the value of moving from Light to Flex on the booking page.

Render an upsell panel that highlights the price delta and added services from Economy Light to Economy Flex for the selected offer.

Agent-Driven Fare Recommendation

An AI travel agent asked 'should I upgrade to flex on this fare?' can call the upsell endpoint with the selected offer and reason over the response. Through Jentic the agent searches for 'show branded fare options for a flight offer', loads the schema, posts the offer, and returns a natural-language recommendation comparing what the user gets at each tier.

Use Jentic to call the upsell operation with the selected flight offer and produce a natural-language comparison of the available fare tiers.

Key Endpoints

1 endpoints — the amadeus branded fares upsell api takes a flight offer and returns the carrier's branded fare families for that itinerary, complete with included services such as bags, seat selection, and refundability.

METHOD

PATH

DESCRIPTION

POST

/shopping/flight-offers/upselling

Get branded fare options for a flight offer

POST

/shopping/flight-offers/upselling

Get branded fare options for a flight offer

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 performs 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 'show the branded fare options for this flight offer', and Jentic returns the /shopping/flight-offers/upselling operation with its input schema so the agent posts the offer and reads the fare tiers without browsing the Amadeus docs.

Time to first call

FAQs

Specific to using Branded Fares Upsell API through Jentic.

What authentication does the Branded Fares Upsell 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-offers/upselling POST. Through Jentic the credentials live in the encrypted vault and the bearer token never reaches the agent prompt.

What input does the upsell endpoint expect?

It expects a flight offer payload - typically the response object from a Flight Offers Search call - wrapped in the request body. The endpoint then returns the branded fare families that match the same itinerary, so the upsell call is always paired with a prior search.

What are the rate limits for the Branded Fares Upsell API?

Rate limits are not declared in the OpenAPI spec and depend on the Amadeus contract tier. The upsell call is heavier than a reference-data lookup, so expect a tighter per-second cap and queue or batch when running comparison scans across many offers.

How do I show branded fare options through Jentic?

Run pip install jentic, then use the search query 'show branded fare options for a flight offer'. Jentic returns the /shopping/flight-offers/upselling operation, you load the schema, post the flight offer object, and execute. The response includes every branded tier and its included services.

Does every carrier return branded fares?

No. The response depends on whether the carrier publishes branded fare content into the Amadeus distribution stream for that itinerary. Carriers that have not enabled branded fares return only the base offer, so always handle the case where the response contains a single tier.

Is the Branded Fares Upsell API free?

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

Can I limit what my agent is allowed to do with the Branded Fares Upsell API?

Yes. Because your Jentic One instance is self-hosted, your own rules decide which operations and credentials the agent may use. Since the flight offer travels in the request body rather than a URL path, scoping is by operation, so you can allow only the upsell call that expands a flight offer into its branded fare families. The agent cannot reach flight search, pricing, or booking operations unless you explicitly grant them.