Docs
Get an API key
Flight Bookings

List a booking's purchasable bags

GET
/v1/flight/bookings/{id}/available-services

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.

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/available-services"
{  "data": [    {      "id": "ase_00009UhD4ongolulWd9123",      "type": "BAGGAGE",      "baggage": {        "type": "CHECKED",        "max_weight_kg": 23      },      "passenger_id": "psg_0192f3a4b5c6",      "segment_ids": [        "string"      ],      "maximum_quantity": 1,      "unit_amount": {        "amount": 40,        "currency": "USD"      }    }  ]}

Quote a cancellation GET

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.

Buy bags for a booking POST

Buys bags on a confirmed booking with a saved card, as its own payment. The call is synchronous: success means the supplier confirmed the bags and Flight saved them and their totals. Payment capture is attempted before confirmation; a capture failure does not undo supplier-confirmed bags. Repeating an `x-idempotency-key` never charges or buys again: a completed purchase returns the current booking, a declined card returns 422 `payment_failed`, and a supplier refusal returns 422 `supplier_rejected`. A purchase that is still pending or has an unknown outcome returns 500 `result_unknown`, including on repeated requests. Do not submit it with a new key; it requires reconciliation. A new attempt after a known refusal or decline needs a new key.