Overview

Returns refund eligibility, estimated refund amounts, and penalty details for a booking without actually cancelling it. Use this before calling POST /flights/bookings/{bookingId}/cancellations to understand the financial impact of cancellation.

When to Use

• Pre-cancellation review — Show the customer the potential maximum refund (not guaranteed) before they confirm cancellation
• Refund estimation — Display potential maximum refund and penalty amounts in the booking management UI (refund is not granted until cancel completes)
• Eligibility check — Determine whether the booking is within the void window (isVoidable) or eligible for a partial refund (isRefundable)

What You Get

• confidence — How reliable the quote is (confirmed, estimated, heuristic, unknown)
• isRefundable / isVoidable — Quick eligibility flags
• refund / penalty — Aggregate amounts with margin applied. refund is the potential maximum the airline may refund — not a granted/guaranteed amount
• penalties[] — Itemised penalty breakdown when available
• tickets[] — Per-ticket detail when available
• destination — Where refunded money goes (original_payment, agency_deposit, voucher, etc.)
• vouchers[] — Airline travel vouchers / credit-shells when destination is voucher; omitted when absent. Distinct from LiteAPI discount voucherCode on prebook

Concurrent cancellation

If a cancellation was already submitted and is still awaiting provider confirmation, this endpoint returns HTTP 409 with code 49007 (CONCURRENT_OPERATION). A new quote is not available until that cancellation completes or fails.

Refund amount caveat

The refund amount on a cancellation quote is the potential maximum the airline may refund if cancellation proceeds under the quoted conditions. It is an estimate for decision-making only and is not granted — the final refund (if any) is determined when cancellation completes and may be lower or zero. The refund may arrive asynchronously once the airline determines the final amount.

Key Features

• Non-destructive — Does not cancel the booking; safe to call before user confirmation
• Margin-applied pricing — All amounts (including voucher pricing.display) reflect the same margin applied at booking time
• Booking currency — Every amount, including tickets[] and penalties[] lines, is returned in the booking currency. Amounts the airline quotes in another currency are converted at the rate implied by the quote itself, or at the current exchange rate when the quote does not price them in the booking currency

Quick Start

Provide the bookingId from POST /flights/bookings in the URL path. Every call hits the upstream provider — do not place this on a hot polling loop.