Amadeus Branded Fares Upsell

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

✓ Official Vendor SpecE CommerceStorefrontoauth21 EndpointsREST

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.

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

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. The single POST to /shopping/flight-offers/upselling sends an existing flight offer payload back to Amadeus and gets matching upsell options, so booking flows can present 'Economy Light' through 'Business Flex' tiers side by side. It targets airline.com replacement experiences and corporate booking tools that need branded merchandising rather than a single base fare.

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

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 'show branded fare options for a flight offer' and Jentic returns the /shopping/flight-offers/upselling operation with its input schema, removing the need to scan the Amadeus self-service docs first.

Time to first call

Direct Amadeus integration: 1-2 days to wire OAuth, request shaping for the offer payload, and rendering of branded tiers. Through Jentic: under one hour — search, load, execute.

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.