Complete a standard Flight Offers Price call to obtain a confirmed price for a base economy fare
POST the priced FlightOffer object to /v1/shopping/flight-offers/upselling
Parse the upselling response array to extract each branded fare's fareName, includedCheckedBags, and amenities list
Display fare families ranked by total price with their includedServices attributes
Allow the user to select a branded fare and re-issue a Flight Offers Price call on that specific offer
Proceed to Flight Create Order with the re-priced branded fare offer
Known gotchas
DECOMMISSIONED 2026-07-17: Amadeus shut down the Self-Service APIs portal — self-service API keys are disabled and the portal is inaccessible as of this date. These endpoints remain available only through an Amadeus Enterprise contract (Enterprise portal unaffected). Self-serve alternatives: Duffel, or an aggregator. Do not attempt self-service key registration; it was paused before shutdown.
The upselling endpoint requires the full FlightOffer object from a prior Price call, not from Search; submitting a Search response directly causes a validation error
Not all airlines provide branded fare upsell data through Amadeus; missing brandedFareLabel in the response means the airline has not loaded fare families into the GDS
Amenities are returned as a list of amenityType codes; mapping them to human-readable descriptions requires a static lookup table, as Amadeus does not supply descriptions in the response
Give your agent this knowledge — and 15,600+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?