Retrieve fare rules and parse penalty amounts using the Amadeus Fare Rules API

domain: amadeus · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. After obtaining a flight offer from Flight Offers Search, call POST /v1/shopping/flight-offers/pricing with the full offer and include=detailed-fare-rules as a query parameter to get fare-rule data alongside the confirmed price.
  2. Parse each traveler's fareDetailsBySegment[].fareRules.rules[] array; each element is a TermAndCondition object whose category is exactly one of REFUND, EXCHANGE, REVALIDATION, REISSUE, REBOOK, or CANCELLATION — there is no PENALTIES category.
  3. Read notApplicable (boolean) to see whether a given rule applies at all, and maxPenaltyAmount for the fee ceiling on that rule; the surrounding FareRules object also carries a currency field for that amount.
  4. For free-text detail (exact conditions, deadlines relative to departure, exceptions), read descriptions[].text on the rule — the structured fields only give category, applicability, and a penalty ceiling.
  5. Summarize the rules in plain language for the traveler: changeable (via EXCHANGE/REBOOK rules) and refundable (via REFUND/CANCELLATION rules), each with yes/no/fee-amount.
  6. Cache parsed fare rules alongside the offer; they are tied to the specific fareDetailsBySegment/fare basis code and should not be reused across different offers.

Known gotchas

Related routes

Parse and display baggage allowance information from an Amadeus flight offer
amadeus · 6 steps · unrated
Retrieve and apply ATPCO fare rules (CAT 15 sales restrictions) before ticketing in an Amadeus flow
developers.amadeus.com · 6 steps · unrated
Parse and apply ATPCO fare rule categories CAT16 penalties and CAT31 reissue conditions before booking
atpco.net · 5 steps · unrated

Give your agent this knowledge — and 15,500+ 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?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans