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

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.