Docs
Get an API key
Flight Bookings

Quote a cancellation

GET
/v1/flight/bookings/{id}/cancellation-quote

What cancelling right now would cost. It asks the airline for its own quote and moves no money; for a Duffel booking the airline prepares a cancellation that is never confirmed and lapses on its own. When the airline cannot answer, you receive an estimate from the fare terms stored on the booking instead, and source says which one you have. The quote is advisory: the airline decides the real fee when the cancel lands. When the money fields are absent, unavailable_reason says why; that is not a free cancellation. Every call asks the airline again, so do not poll it.

Authorization

x-api-key<token>

Your API key. Issued and revoked from the TrustPixel dashboard; the gateway resolves it to an owning organization on every request.

In: header

Path Parameters

id*string

Header Parameters

x-request-id?string

Correlation id echoed to the upstream service and returned on the response. Generated as req_<uuid> when omitted.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/flight/bookings/string/cancellation-quote"
{  "data": {    "source": "SUPPLIER_QUOTE",    "is_free": false,    "fee": {      "amount": 150,      "currency": "USD"    },    "refundable_amount": {      "amount": 70.67,      "currency": "USD"    },    "quoted_at": "2026-11-01T09:12:44.000Z",    "unavailable_reason": "no_policy"  }}

Cancel a booking POST

Starts a background cancellation and returns immediately. Poll GET /v1/flight/bookings/{id} for supplier cancellation: CANCELED means the ticket was released; CONFIRMED means it remains valid after a rejected cancellation. The cancellation block contains the supplier fee and intended refund_amount, not refund settlement. After supplier success, the workflow submits refund requests to Payment and completes when they are accepted. Payment owns subsequent processing. A repeated request does not restart an active or completed run; it can restart a failed run, including refund submission for an already canceled booking. Canceled bookings return 200; cancellations in progress return 202. Validation failures return 4xx.

List a booking's purchasable bags GET

Bags the airline sells on a confirmed booking right now, asked live. Empty when the airline sells none after booking, or the booking already carries bags. 409 unless the booking is `CONFIRMED`.