Retrieve and apply ATPCO fare rules (CAT 15 sales restrictions) before ticketing in an Amadeus flow

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

This API has logged drift

developers.amadeus.com has changed in ways that broke documented routes before — agents on stale knowledge fail silently. Get alerted when developers.amadeus.com drifts again →

Steps

  1. After a Flight Offers Search, select the chosen offer and call POST /v1/shopping/flight-offers/pricing with the full offer and include=detailed-fare-rules as a query parameter — there is no separate /v1/shopping/airTraffic/fares endpoint; fare rules are only surfaced through this pricing call.
  2. Parse each traveler's fareDetailsBySegment[].fareRules.rules[] array; each rule is a TermAndCondition object limited to category REFUND, EXCHANGE, REVALIDATION, REISSUE, REBOOK, or CANCELLATION, plus circumstances, notApplicable, maxPenaltyAmount, and a descriptions[] array of free-text blocks.
  3. Traditional ATPCO CAT 15 content (advance-purchase requirements, blackout dates, point-of-sale/channel restrictions) is not exposed as its own structured category in the Self-Service fare-rules response; look for it inside descriptions[].text on the applicable rule rather than a dedicated field.
  4. Cross-check any advance-purchase or point-of-sale restriction you find in the free text against the booking channel and market before proceeding, since Self-Service does not guarantee complete ATPCO rule text in every market.
  5. Surface any restriction you can actually confirm (fee amount, deadline, applicability) to the traveler in plain language before ticketing; do not claim a CAT 15 sales restriction was checked if the text wasn't present in the response.
  6. If your product requires guaranteed, comprehensive ATPCO CAT 15 sales-restriction data rather than best-effort text embedded in refund/exchange/cancellation rules, that level of coverage is an Amadeus Enterprise API capability, not Self-Service.

Known gotchas

Related routes

Parse and apply ATPCO fare rule categories CAT16 penalties and CAT31 reissue conditions before booking
atpco.net · 5 steps · unrated
Retrieve fare rules and parse penalty amounts using the Amadeus Fare Rules API
amadeus · 6 steps · unrated

Give your agent this knowledge — and 15,800+ more routes

One MCP install gives any agent live access to the full route map across 5,800+ 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