{"openapi":"3.1.0","info":{"title":"Flyzafy Merchant API","version":"1.0.0","description":"Search, price, book and issue flights from your own systems — search, availability, price, upsell, seat maps, book, issue, retrieve, update and cancel, at your selling price. Bookings are paid from your prepaid organisation wallet, **only when the ticket is issued**; no card data passes through the API.\n\n**Authentication:** POST /security/token with your client id and secret (the two parts of your key `fz_live_<client id>.<client secret>`) gives an access token for 30 minutes; send `Authorization: Bearer <access_token>` on every other call.\n**Errors:** every error is `{ \"error\": { \"code\", \"message\", \"requestId\", \"details\"? } }`. `code` is stable; `message` is for people.\n**Idempotency:** every request that creates or changes a booking needs an `Idempotency-Key` header (8–128 characters). A retry with the same key returns the first result (`Idempotent-Replayed: true`); the same key with a different body is refused (409 `IDEMPOTENCY_KEY_REUSED`); a retry while the first is still running gets 409 `IDEMPOTENCY_IN_PROGRESS`. A failed request is not stored, so it can be retried with the same key.\n**Rate limits:** per merchant, per minute and per UTC day, plus a lower limit for searches. Every reply carries `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset`; a 429 carries `Retry-After` (seconds).\n**Money:** amounts are decimal strings with 2 decimals (`\"848.80\"`) in `currency`. Request fields such as `expectedTotal` are JSON numbers. A hold charges nothing; issuing charges the booking total (seats included); a refused ticket charges nothing.\n**Pending bookings:** if the airline gives no clear answer, the booking is returned with status `PENDING_CONFIRMATION` and our team settles it; you are told by webhook.\n**Webhooks:** each delivery has `Webhook-Id`, `Webhook-Timestamp` and `Webhook-Signature: v1=<hex HMAC-SHA256(secret, \"<id>.<timestamp>.<raw body>\")>`. Check the signature, refuse timestamps older than 5 minutes, and de-duplicate on `Webhook-Id`. Failed deliveries are retried for 24 hours (1 min, 5 min, 30 min, 2 h, 6 h, 12 h).\n\nExamples are real exchanges (2026-11-18); long lists are trimmed and personal data replaced."},"servers":[{"url":"https://staging-api.airhux.com/v1/partner","description":"Production"}],"security":[{"bearer":[]}],"tags":[{"name":"Authentication","description":"Access tokens (OAuth2 client credentials)."},{"name":"Shopping","description":"Search → (availability) → price → upsell / seat maps / extras. Nothing is booked or charged."},{"name":"Booking","description":"Book (hold or issue) → issue → read live → add seats or documents → cancel. Charged only when the ticket is issued."},{"name":"Webhooks","description":"Signed event notifications to your server."}],"x-common-errors":[{"status":400,"code":"INVALID_REQUEST","when":"A parameter or body field is missing, has the wrong type, or is not allowed. `details.fields` lists each problem.","example":{"error":{"code":"INVALID_REQUEST","message":"The address must start with https://","requestId":"2a3cd391-0791-4d40-b9a7-ca7f9ce42752"}}},{"status":401,"code":"UNAUTHORIZED","when":"No `Authorization: Bearer <access token>` header. Get a token from POST /security/token.","example":{"error":{"code":"UNAUTHORIZED","message":"Send an access token as: Authorization: Bearer <token>. Get one from POST /v1/partner/security/token.","requestId":"4dd59917-0f5a-482f-891e-7190a0964ea3"}}},{"status":401,"code":"INVALID_TOKEN","when":"The access token is unknown or expired (tokens last 30 minutes), or it is a raw API key. Get a new token.","example":{"error":{"code":"INVALID_TOKEN","message":"The access token is not valid or has expired. Get a new one from POST /v1/partner/security/token.","requestId":"3f620f90-feb3-417d-b089-9a1afda4e16f"}}},{"status":401,"code":"API_KEY_EXPIRED","when":"The key behind the token passed its expiry date.","example":{"error":{"code":"API_KEY_EXPIRED","message":"This API key has expired. Use its replacement.","requestId":"0084bab3-f2f4-4692-9530-ab22194ca36f"}}},{"status":403,"code":"IP_NOT_ALLOWED","when":"The key has an IP allowlist and the call came from another address.","example":{"error":{"code":"IP_NOT_ALLOWED","message":"This key cannot be used from 127.0.0.1. Add the address to the key's IP allowlist.","requestId":"8e15feff-e402-4854-afe4-1d6e55b06d27"}}},{"status":403,"code":"INSUFFICIENT_SCOPE","when":"The key does not have the permission this endpoint needs (`details.requiredScope`).","example":{"error":{"code":"INSUFFICIENT_SCOPE","message":"This API key does not have the \"flights:book\" permission.","requestId":"1ef791a0-1de3-4776-b2ba-7b0e74331a33","details":{"requiredScope":"flights:book"}}}},{"status":403,"code":"PRODUCT_NOT_ENABLED","when":"Flights are not enabled for your account.","example":{"error":{"code":"PRODUCT_NOT_ENABLED","message":"Flights are not enabled for your account.","requestId":"2fa3a4e1-f356-4124-95d8-2a4341115f77","details":{"product":"flights"}}}},{"status":403,"code":"MERCHANT_SUSPENDED","when":"Your API access is suspended. Every key is refused; nothing was deleted.","example":{"error":{"code":"MERCHANT_SUSPENDED","message":"API access for this organisation is suspended. Contact your account manager.","requestId":"0de4e7d9-9db4-4006-9a15-3d66d2a1763f"}}},{"status":403,"code":"MERCHANT_INACTIVE","when":"Your API access was revoked or your organisation is not active.","example":{"error":{"code":"MERCHANT_INACTIVE","message":"This organisation is not active.","requestId":"f9c2da81-6ba9-42b0-b273-16cffd99310c"}}},{"status":403,"code":"API_ACCESS_DISABLED","when":"API access is switched off for your organisation.","example":{"error":{"code":"API_ACCESS_DISABLED","message":"API access is not enabled for this organisation.","requestId":"b91cf467-3519-4654-9933-73a9fc81edff"}}},{"status":429,"code":"RATE_LIMITED","when":"Too many requests. Wait `Retry-After` seconds (`details.retryAfterSeconds`).","example":{"error":{"code":"RATE_LIMITED","message":"Too many requests this minute.","requestId":"f4502c3b-226b-49ae-84a3-5e7e4ae9be7f","details":{"retryAfterSeconds":45,"limit":1}}}},{"status":500,"code":"INTERNAL_ERROR","when":"Something went wrong on our side. Retry with the same Idempotency-Key, or contact us with the `requestId`."},{"status":502,"code":"SUPPLIER_ERROR","when":"The airline system answered with an error."},{"status":503,"code":"UNAVAILABLE","when":"The service is temporarily unavailable. Retry later."},{"status":504,"code":"SUPPLIER_TIMEOUT","when":"The airline system did not answer in time. For a booking, read it back before retrying: it may exist."}],"x-idempotency-errors":[{"status":400,"code":"IDEMPOTENCY_KEY_REQUIRED","when":"The `Idempotency-Key` header is missing.","example":{"error":{"code":"IDEMPOTENCY_KEY_REQUIRED","message":"Send a unique Idempotency-Key header (8–128 characters) with this request.","requestId":"e84a4120-641a-4dd6-8325-4592ca3cad69"}}},{"status":400,"code":"INVALID_IDEMPOTENCY_KEY","when":"The `Idempotency-Key` is not 8–128 characters of letters, digits, `.`, `_`, `:` or `-`.","example":{"error":{"code":"INVALID_IDEMPOTENCY_KEY","message":"The Idempotency-Key must be 8–128 letters, digits or . _ : -","requestId":"95651dd6-31d2-4961-990f-8a854583532c"}}},{"status":409,"code":"IDEMPOTENCY_KEY_REUSED","when":"This Idempotency-Key was used before with a different body.","example":{"error":{"code":"IDEMPOTENCY_KEY_REUSED","message":"This Idempotency-Key was already used with a different request.","requestId":"2aecf99b-513d-4602-ae77-3c53bcb116fe"}}},{"status":409,"code":"IDEMPOTENCY_IN_PROGRESS","when":"A request with this Idempotency-Key is still running. Retry in a few seconds.","example":{"error":{"code":"IDEMPOTENCY_IN_PROGRESS","message":"A request with this Idempotency-Key is still being processed. Retry later.","requestId":"89948d68-d515-4592-aef7-e0499b6e4161"}}}],"paths":{"/security/token":{"post":{"operationId":"getToken","tags":["Authentication"],"summary":"Get an access token","description":"Trade your client id and secret for an access token (30 minutes), then send `Authorization: Bearer <access_token>` on every other call. Get a new token shortly before `expires_in` runs out; a token stops working at once if its key is revoked or expires.","security":[],"x-try-it":false,"x-errors":[{"status":400,"code":"INVALID_REQUEST","when":"`grant_type`, `client_id` or `client_secret` is missing (`details.missing`).","example":{"error":{"code":"INVALID_REQUEST","message":"Missing: client_secret.","requestId":"54ae79d8-23ae-44f0-b5c9-4967a683e138","details":{"missing":["client_secret"]}}}},{"status":400,"code":"UNSUPPORTED_GRANT_TYPE","when":"`grant_type` is not `client_credentials`.","example":{"error":{"code":"UNSUPPORTED_GRANT_TYPE","message":"Only grant_type=client_credentials is supported.","requestId":"12066ef7-1b01-43b0-8ca3-4532c95b5a65"}}},{"status":401,"code":"INVALID_CLIENT","when":"The client id or secret is wrong, or the key was revoked.","example":{"error":{"code":"INVALID_CLIENT","message":"The client id or client secret is not valid.","requestId":"a77538f2-173a-48d8-b550-8e392f4b3040"}}},{"status":401,"code":"API_KEY_EXPIRED","when":"The key passed its expiry date.","example":{"error":{"code":"API_KEY_EXPIRED","message":"This API key has expired. Use its replacement.","requestId":"0084bab3-f2f4-4692-9530-ab22194ca36f"}}},{"status":403,"code":"IP_NOT_ALLOWED","when":"The key has an IP allowlist and the call came from another address.","example":{"error":{"code":"IP_NOT_ALLOWED","message":"This key cannot be used from 127.0.0.1. Add the address to the key's IP allowlist.","requestId":"8e15feff-e402-4854-afe4-1d6e55b06d27"}}},{"status":403,"code":"MERCHANT_SUSPENDED","when":"Your API access is suspended.","example":{"error":{"code":"MERCHANT_SUSPENDED","message":"API access for this organisation is suspended. Contact your account manager.","requestId":"5e2bc331-b9e8-4c24-a126-6b3b529253f2"}}},{"status":403,"code":"MERCHANT_INACTIVE","when":"Your API access was revoked or your organisation is not active.","example":{"error":{"code":"MERCHANT_INACTIVE","message":"This organisation is not active.","requestId":"e443bedf-c683-437a-8ad8-eb5484bcb053"}}},{"status":403,"code":"API_ACCESS_DISABLED","when":"API access is switched off for your organisation.","example":{"error":{"code":"API_ACCESS_DISABLED","message":"API access is not enabled for this organisation.","requestId":"bf367a44-a8a4-4e2b-bb46-4b10a94e7f06"}}},{"status":429,"code":"RATE_LIMITED","when":"More than 30 token requests a minute from your address. Reuse the token: it lasts 30 minutes.","example":{"error":{"code":"RATE_LIMITED","message":"Too many token requests. Try again in 44 seconds; a token lasts 30 minutes, so reuse it.","requestId":"13948978-03fe-46e6-819f-3add846b2f28","details":{"retryAfterSeconds":44,"limit":30}}}}],"parameters":[{"$ref":"#/components/parameters/RequestId"}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","description":"Client credentials (OAuth2).","properties":{"grant_type":{"type":"string","description":"Always `client_credentials`.","enum":["client_credentials"]},"client_id":{"type":"string","description":"Your key id (the part of the key between `fz_live_` and the dot)."},"client_secret":{"type":"string","description":"Your key secret (the part of the key after the dot). Shown once, when the key is made."}},"required":["grant_type","client_id","client_secret"]}},"application/json":{"schema":{"type":"object","description":"Client credentials (OAuth2).","properties":{"grant_type":{"type":"string","description":"Always `client_credentials`.","enum":["client_credentials"]},"client_id":{"type":"string","description":"Your key id (the part of the key between `fz_live_` and the dot)."},"client_secret":{"type":"string","description":"Your key secret (the part of the key after the dot). Shown once, when the key is made."}},"required":["grant_type","client_id","client_secret"]},"example":{"grant_type":"client_credentials","client_id":"<key id>","client_secret":"<key secret>"}}}},"responses":{"200":{"description":"The token.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenResponse"},"example":{"token_type":"Bearer","access_token":"<redacted>","expires_in":1799,"scope":"flights:search flights:book flights:manage bookings:read webhooks:manage"},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/flights/offers":{"get":{"operationId":"searchFlightsGet","tags":["Shopping"],"summary":"Search flights (GET)","description":"Search flights (GET). One-way or return search as query parameters; prices are your selling price. For multi-city use POST /flights/offers/search. Offers stay bookable for 20 minutes (`expiresAt`).","x-scope":"flights:search","x-try-it":true,"x-errors":[{"status":422,"code":"NO_ALLOWED_AIRLINE","when":"None of the requested airlines is enabled for your account.","example":{"error":{"code":"NO_ALLOWED_AIRLINE","message":"None of the requested airlines is enabled for your account.","requestId":"9dea03f8-f2c3-45a1-8263-79eadb0b8b6d"}}}],"parameters":[{"name":"origin","in":"query","required":true,"description":"Departure airport or city (IATA).","schema":{"type":"string","description":"IATA code.","pattern":"^[A-Za-z]{3}$","minLength":3,"maxLength":3},"example":"DXB"},{"name":"destination","in":"query","required":true,"description":"Arrival airport or city (IATA).","schema":{"type":"string","description":"IATA code.","pattern":"^[A-Za-z]{3}$","minLength":3,"maxLength":3},"example":"LHR"},{"name":"departureDate","in":"query","required":true,"description":"Departure day, YYYY-MM-DD (local).","schema":{"type":"string","description":"Date.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","format":"date"},"example":"2027-01-02"},{"name":"returnDate","in":"query","required":false,"description":"Return day for a round trip.","schema":{"type":"string","description":"Date.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","format":"date"}},{"name":"adults","in":"query","required":false,"description":"Adults (12+), 1–9.","schema":{"type":"integer","description":"Count.","minimum":1,"maximum":9,"default":1},"example":"1"},{"name":"children","in":"query","required":false,"description":"Children 2–11.","schema":{"type":"integer","description":"Count.","minimum":0,"maximum":8,"default":0}},{"name":"infants","in":"query","required":false,"description":"Infants under 2 on an adult’s lap.","schema":{"type":"integer","description":"Count.","minimum":0,"maximum":9,"default":0}},{"name":"infantsWithSeat","in":"query","required":false,"description":"Infants under 2 with their own seat.","schema":{"type":"integer","description":"Count.","minimum":0,"maximum":8,"default":0}},{"name":"cabin","in":"query","required":false,"description":"Cabin.","schema":{"type":"string","description":"Cabin.","enum":["ECONOMY","PREMIUM_ECONOMY","BUSINESS","FIRST"],"default":"ECONOMY"}},{"name":"currency","in":"query","required":false,"description":"Currency of the prices; only charge currencies are accepted (USD).","schema":{"type":"string","description":"ISO 4217.","pattern":"^[A-Za-z]{3}$"}},{"name":"nonStop","in":"query","required":false,"description":"Direct flights only.","schema":{"type":"boolean","description":"true or false."}},{"name":"maxConnections","in":"query","required":false,"description":"At most this many connections per direction (0–2).","schema":{"type":"integer","description":"Count.","minimum":0,"maximum":2}},{"name":"includeAirlines","in":"query","required":false,"description":"Only these airlines, comma-separated IATA codes (e.g. EK,QR).","schema":{"type":"string","description":"Comma-separated codes."},"example":"EK"},{"name":"excludeAirlines","in":"query","required":false,"description":"Never these airlines, comma-separated IATA codes.","schema":{"type":"string","description":"Comma-separated codes."}},{"name":"refundableOnly","in":"query","required":false,"description":"Only refundable fares.","schema":{"type":"boolean","description":"true or false."}},{"name":"checkedBagOnly","in":"query","required":false,"description":"Only fares with a checked bag included.","schema":{"type":"boolean","description":"true or false."}},{"name":"limit","in":"query","required":false,"description":"At most this many offers.","schema":{"type":"integer","description":"Count.","minimum":1,"maximum":250,"default":100},"example":"20"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"The offers.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlightSearchResult"},"example":{"searchId":"i3eu4-6A2ckn","expiresAt":"2026-11-18T15:19:51.969Z","count":2,"offers":[{"offerId":"of_i3eu4-6A2ckn_1","groupId":"g1","validatingCarrier":"EK","lastTicketingDate":null,"seatsAvailable":null,"price":{"currency":"USD","total":"1265.80","base":"1152.00","taxes":"113.80"},"itineraries":[{"duration":"PT7H55M","segments":[{"id":"4","carrier":"EK","flightNumber":"1","operatingCarrier":"EK","from":{"airport":"DXB","terminal":"3","at":"2027-01-02T07:45:00"},"to":{"airport":"LHR","terminal":"3","at":"2027-01-02T11:40:00"},"duration":"PT7H55M","aircraft":"388","stops":0}]}],"fares":[{"travelerId":"1","travelerType":"ADULT","total":"1265.80","segments":[{"segmentId":"4","cabin":"ECONOMY","bookingClass":"Y","fareBasis":"YLOWFAE1","brand":"YF","brandLabel":"Economy Flex Plus","checkedBags":{"quantity":null,"weight":35,"weightUnit":"KG"},"cabinBags":null}]}]},{"offerId":"of_i3eu4-6A2ckn_2","groupId":"g1","validatingCarrier":"EK","lastTicketingDate":null,"seatsAvailable":null,"price":{"currency":"USD","total":"1586.80","base":"1473.00","taxes":"113.80"},"itineraries":[{"duration":"PT7H55M","segments":[{"id":"4","carrier":"EK","flightNumber":"1","operatingCarrier":"EK","from":{"airport":"DXB","terminal":"3","at":"2027-01-02T07:45:00"},"to":{"airport":"LHR","terminal":"3","at":"2027-01-02T11:40:00"},"duration":"PT7H55M","aircraft":"388","stops":0}]}],"fares":[{"travelerId":"1","travelerType":"ADULT","total":"1586.80","segments":[{"segmentId":"4","cabin":"PREMIUM_ECONOMY","bookingClass":"W","fareBasis":"WLPOFAE1","brand":"WF","brandLabel":"Premium Economy FlexPlus","checkedBags":{"quantity":null,"weight":35,"weightUnit":"KG"},"cabinBags":null}]}]}]},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"422":{"$ref":"#/components/responses/E422"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/flights/offers/search":{"post":{"operationId":"searchFlights","tags":["Shopping"],"summary":"Search flights","description":"Search flights (POST): one-way, return or multi-city (2–6 slices). Prices are your selling price. Offers stay bookable for 20 minutes (`expiresAt`).","x-scope":"flights:search","x-try-it":true,"x-errors":[{"status":422,"code":"NO_ALLOWED_AIRLINE","when":"None of the requested airlines is enabled for your account.","example":{"error":{"code":"NO_ALLOWED_AIRLINE","message":"None of the requested airlines is enabled for your account.","requestId":"96154cca-7307-4a68-a0f4-26c5e19e7b09"}}}],"parameters":[{"$ref":"#/components/parameters/RequestId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlightSearchRequest"},"example":{"slices":[{"origin":"JFK","destination":"LHR","departureDate":"2027-01-07"},{"origin":"LHR","destination":"CDG","departureDate":"2027-01-12"}],"adults":1,"cabin":"ECONOMY","limit":2}}}},"responses":{"200":{"description":"The offers.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlightSearchResult"},"example":{"searchId":"VsKRe7JLA358","expiresAt":"2026-11-18T15:20:10.655Z","count":2,"offers":[{"offerId":"of_VsKRe7JLA358_1","groupId":"g1","validatingCarrier":"AA","lastTicketingDate":"2026-11-21","seatsAvailable":null,"price":{"currency":"USD","total":"661.80","base":"321.00","taxes":"340.80"},"itineraries":[{"duration":"PT6H55M","segments":[{"id":"33","carrier":"AA","flightNumber":"100","operatingCarrier":"AA","from":{"airport":"JFK","terminal":"8","at":"2027-01-07T18:25:00"},"to":{"airport":"LHR","terminal":"3","at":"2027-01-08T06:20:00"},"duration":"PT6H55M","aircraft":"77W","stops":0}]},{"duration":"PT1H25M","segments":[{"id":"68","carrier":"AA","flightNumber":"7217","operatingCarrier":"BA","from":{"airport":"LHR","terminal":"5","at":"2027-01-12T14:55:00"},"to":{"airport":"CDG","terminal":"2C","at":"2027-01-12T17:20:00"},"duration":"PT1H25M","aircraft":"321","stops":0}]}],"fares":[{"travelerId":"1","travelerType":"ADULT","total":"661.80","segments":[{"segmentId":"33","cabin":"ECONOMY","bookingClass":"O","fareBasis":"OLN2T9M5","brand":"AAAT-MAIN","brandLabel":"Main Cabin","checkedBags":{"quantity":1,"weight":null,"weightUnit":null},"cabinBags":{"quantity":1,"weight":null,"weightUnit":null}},{"segmentId":"68","cabin":"ECONOMY","bookingClass":"S","fareBasis":"OLN2T9M5","brand":"AAAT-MAIN","brandLabel":"Main Cabin","checkedBags":{"quantity":1,"weight":null,"weightUnit":null},"cabinBags":{"quantity":2,"weight":null,"weightUnit":null}}]}]},{"offerId":"of_VsKRe7JLA358_2","groupId":"g1","validatingCarrier":"AA","lastTicketingDate":"2026-11-21","seatsAvailable":null,"price":{"currency":"USD","total":"774.80","base":"434.00","taxes":"340.80"},"itineraries":[{"duration":"PT6H55M","segments":[{"id":"33","carrier":"AA","flightNumber":"100","operatingCarrier":"AA","from":{"airport":"JFK","terminal":"8","at":"2027-01-07T18:25:00"},"to":{"airport":"LHR","terminal":"3","at":"2027-01-08T06:20:00"},"duration":"PT6H55M","aircraft":"77W","stops":0}]},{"duration":"PT1H25M","segments":[{"id":"68","carrier":"AA","flightNumber":"7217","operatingCarrier":"BA","from":{"airport":"LHR","terminal":"5","at":"2027-01-12T14:55:00"},"to":{"airport":"CDG","terminal":"2C","at":"2027-01-12T17:20:00"},"duration":"PT1H25M","aircraft":"321","stops":0}]}],"fares":[{"travelerId":"1","travelerType":"ADULT","total":"774.80","segments":[{"segmentId":"33","cabin":"ECONOMY","bookingClass":"O","fareBasis":"OLN2T9M9","brand":"AAAT-MAINFL","brandLabel":"Main Cabin Flexible","checkedBags":{"quantity":1,"weight":null,"weightUnit":null},"cabinBags":{"quantity":1,"weight":null,"weightUnit":null}},{"segmentId":"68","cabin":"ECONOMY","bookingClass":"S","fareBasis":"OLN2T9M9","brand":"AAAT-MAINFL","brandLabel":"Main Cabin Flexible","checkedBags":{"quantity":1,"weight":null,"weightUnit":null},"cabinBags":{"quantity":2,"weight":null,"weightUnit":null}}]}]}]},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"422":{"$ref":"#/components/responses/E422"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/flights/availability":{"post":{"operationId":"flightAvailability","tags":["Shopping"],"summary":"Seat availability","description":"Flight availability: the flights on 1–6 slices with the seats left in each booking class. No prices and nothing bookable — use Search flights to buy. Some airlines sell only through Search flights and are not listed here.","x-scope":"flights:search","x-try-it":true,"x-errors":[{"status":422,"code":"NO_ALLOWED_AIRLINE","when":"None of the requested airlines is enabled for your account.","example":{"error":{"code":"NO_ALLOWED_AIRLINE","message":"None of the requested airlines is enabled for your account.","requestId":"d7720f24-796f-49d2-8556-7be4e079587f"}}},{"status":422,"code":"AVAILABILITY_NOT_ENABLED","when":"No content with an availability search is enabled for your account.","example":{"error":{"code":"AVAILABILITY_NOT_ENABLED","message":"No content with an availability search is enabled for your account.","requestId":"ee4d11de-5bbb-46f2-bbba-c4b2bfe78d45"}}}],"parameters":[{"$ref":"#/components/parameters/RequestId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailabilityRequest"},"example":{"slices":[{"origin":"DXB","destination":"LHR","departureDate":"2026-12-28","departureTime":"08:00"}],"adults":1,"cabin":"ECONOMY"}}}},"responses":{"200":{"description":"The flights.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailabilityResult"},"example":{"count":2,"flights":[{"id":"1","slice":0,"instantTicketingRequired":false,"duration":"PT14H5M","segments":[{"id":"75","carrier":"TP","flightNumber":"6730","operatingCarrier":"EK","from":{"airport":"DXB","terminal":"3","at":"2026-12-28T07:25:00"},"to":{"airport":"LIS","terminal":"1","at":"2026-12-28T12:00:00"},"aircraft":"77W","stops":0,"classes":[{"bookingClass":"Y","seats":4},{"bookingClass":"B","seats":4},{"bookingClass":"M","seats":4},{"bookingClass":"H","seats":4},{"bookingClass":"Q","seats":4},{"bookingClass":"V","seats":4},{"bookingClass":"A","seats":4},{"bookingClass":"L","seats":4},{"bookingClass":"U","seats":4},{"bookingClass":"E","seats":null}]},{"id":"76","carrier":"TP","flightNumber":"1356","operatingCarrier":null,"from":{"airport":"LIS","terminal":"1","at":"2026-12-28T14:40:00"},"to":{"airport":"LHR","terminal":"2","at":"2026-12-28T17:30:00"},"aircraft":"32N","stops":0,"classes":[{"bookingClass":"Y","seats":4},{"bookingClass":"B","seats":4},{"bookingClass":"M","seats":4},{"bookingClass":"H","seats":4},{"bookingClass":"Q","seats":4},{"bookingClass":"V","seats":4},{"bookingClass":"A","seats":4},{"bookingClass":"L","seats":4},{"bookingClass":"U","seats":4},{"bookingClass":"E","seats":null},{"bookingClass":"T","seats":null},{"bookingClass":"O","seats":null}]}]},{"id":"2","slice":0,"instantTicketingRequired":false,"duration":"PT11H10M","segments":[{"id":"27","carrier":"GF","flightNumber":"501","operatingCarrier":null,"from":{"airport":"DXB","terminal":"1","at":"2026-12-28T07:35:00"},"to":{"airport":"BAH","terminal":null,"at":"2026-12-28T08:05:00"},"aircraft":"32N","stops":0,"classes":[{"bookingClass":"Y","seats":7},{"bookingClass":"H","seats":7},{"bookingClass":"M","seats":7},{"bookingClass":"L","seats":7},{"bookingClass":"B","seats":7},{"bookingClass":"K","seats":7},{"bookingClass":"X","seats":7},{"bookingClass":"Q","seats":7},{"bookingClass":"V","seats":7},{"bookingClass":"E","seats":7},{"bookingClass":"O","seats":7},{"bookingClass":"N","seats":7},{"bookingClass":"S","seats":7},{"bookingClass":"W","seats":7},{"bookingClass":"G","seats":null}]},{"id":"28","carrier":"GF","flightNumber":"3","operatingCarrier":null,"from":{"airport":"BAH","terminal":null,"at":"2026-12-28T10:30:00"},"to":{"airport":"LHR","terminal":"4","at":"2026-12-28T14:45:00"},"aircraft":"789","stops":0,"classes":[{"bookingClass":"Y","seats":7},{"bookingClass":"H","seats":7},{"bookingClass":"M","seats":7},{"bookingClass":"L","seats":7},{"bookingClass":"B","seats":7},{"bookingClass":"K","seats":7},{"bookingClass":"X","seats":7},{"bookingClass":"Q","seats":7},{"bookingClass":"V","seats":7},{"bookingClass":"E","seats":7},{"bookingClass":"O","seats":7},{"bookingClass":"N","seats":7},{"bookingClass":"S","seats":7},{"bookingClass":"W","seats":7},{"bookingClass":"G","seats":null}]}]}]},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"422":{"$ref":"#/components/responses/E422"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/flights/offers/{offerId}/price":{"post":{"operationId":"priceOffer","tags":["Shopping"],"summary":"Price an offer","description":"Price an offer: the live price of one offer, with its fare rules, change and cancellation penalties, the extra bags the airline sells, and whether it can be held. Returns a `pricedOfferId` to book, upsell, add extras or read seat maps.","x-scope":"flights:search","x-try-it":true,"x-errors":[{"status":404,"code":"OFFER_EXPIRED","when":"The offer is unknown or its search expired. Search again.","example":{"error":{"code":"OFFER_EXPIRED","message":"This offer is unknown or expired. Search again.","requestId":"84204c9f-0ff8-4c0a-a35d-20e6488a7ac4"}}},{"status":422,"code":"OFFER_NOT_AVAILABLE","when":"The airline no longer sells this offer."}],"parameters":[{"name":"offerId","in":"path","required":true,"description":"`offers[].offerId` from a search or an upsell (valid until the search `expiresAt`).","schema":{"type":"string","description":"Offer id.","pattern":"^of_[A-Za-z0-9_-]{12}_\\d{1,4}$"},"example":"of_AbCdEfGhIjKl_1"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"The priced offer.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricedOffer"},"example":{"pricedOfferId":"63ed67f7-2982-485b-9579-e6df219f5225","expiresAt":"2026-11-18T15:30:17.556Z","offer":{"offerId":"63ed67f7-2982-485b-9579-e6df219f5225","groupId":"priced","validatingCarrier":"EK","lastTicketingDate":null,"seatsAvailable":null,"price":{"currency":"USD","total":"1265.80","base":"1152.00","taxes":"113.80"},"itineraries":[{"duration":null,"segments":[{"id":"4","carrier":"EK","flightNumber":"1","operatingCarrier":"EK","from":{"airport":"DXB","terminal":"3","at":"2027-01-02T07:45:00"},"to":{"airport":"LHR","terminal":"3","at":"2027-01-02T11:40:00"},"duration":"PT7H55M","aircraft":"388","stops":0}]}],"fares":[{"travelerId":"1","travelerType":"ADULT","total":"1265.80","segments":[{"segmentId":"4","cabin":"ECONOMY","bookingClass":"Y","fareBasis":"YLOWFAE1","brand":null,"brandLabel":null,"checkedBags":{"quantity":null,"weight":35,"weightUnit":"KG"},"cabinBags":null}]}]},"penalties":[{"type":"CANCELLATION","label":"Cancellation fee","amount":300,"currency":"USD","applicable":true},{"type":"CHANGE","label":"Change fee","amount":200,"currency":"USD","applicable":true}],"fareRules":[{"fareComponent":"1","segmentId":"4","fareBasis":"YLOWFAE1","name":"Economy Flex Plus","rules":[{"type":"TICKET ENDORSMENT","text":"Ticket\n Endorsement NON-END/FLEX PLUS\n "},{"type":"PENALTIES","text":"Penalty\n Cancel 30000 USD MAX\n Change 20000 USD MAX\n "}]}],"bagOptions":[],"extras":{"seats":[],"bags":[]},"bookingRequirements":{"emailAddressRequired":true,"phoneNumberRequired":true},"holdAllowed":{"allowed":false,"reason":"The airline gives no ticketing deadline for this fare, so it cannot be held. Book it with ticketing ISSUE."}},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"422":{"$ref":"#/components/responses/E422"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/flights/priced-offers/{pricedOfferId}":{"get":{"operationId":"getPricedOffer","tags":["Shopping"],"summary":"Get a priced offer","description":"The priced offer again, with any extras added. Nothing is sent to the airline.","x-scope":"flights:search","x-try-it":true,"x-errors":[{"status":404,"code":"PRICED_OFFER_EXPIRED","when":"The priced offer is unknown or expired. Price the offer again.","example":{"error":{"code":"PRICED_OFFER_EXPIRED","message":"This priced offer is unknown or expired. Price the offer again.","requestId":"8eddec14-0266-4e49-a818-a5375bb6ea29"}}}],"parameters":[{"name":"pricedOfferId","in":"path","required":true,"description":"`pricedOfferId` from Price an offer.","schema":{"type":"string","description":"Priced offer id.","maxLength":64},"example":"4837aa60-c394-43fa-b4d9-bc306f3a9a1b"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"The priced offer.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricedOffer"},"example":{"pricedOfferId":"4837aa60-c394-43fa-b4d9-bc306f3a9a1b","expiresAt":"2026-11-18T15:31:13.531Z","offer":{"offerId":"4837aa60-c394-43fa-b4d9-bc306f3a9a1b","groupId":"priced","validatingCarrier":"AC","lastTicketingDate":"2026-11-19","seatsAvailable":null,"price":{"currency":"USD","total":"350.20","base":"280.50","taxes":"69.70"},"itineraries":[{"duration":null,"segments":[{"id":"6","carrier":"AC","flightNumber":"125","operatingCarrier":"AC","from":{"airport":"YYZ","terminal":"1","at":"2027-01-17T20:20:00"},"to":{"airport":"YVR","terminal":"M","at":"2027-01-17T23:22:00"},"duration":"PT5H2M","aircraft":"789","stops":0}]}],"fares":[{"travelerId":"1","travelerType":"ADULT","total":"229.70","segments":[{"segmentId":"6","cabin":"ECONOMY","bookingClass":"G","fareBasis":"GS6NZCTG","brand":"STANDARD","brandLabel":null,"checkedBags":{"quantity":0,"weight":null,"weightUnit":null},"cabinBags":{"quantity":1,"weight":null,"weightUnit":null}}]}]},"penalties":[{"type":"CANCELLATION","label":"Cancellation fee","amount":null,"currency":"USD","applicable":false},{"type":"CHANGE","label":"Change fee","amount":70,"currency":"USD","applicable":true}],"fareRules":[{"fareComponent":"1","segmentId":"6","fareBasis":"GS6NZCTG","name":"ONEWAY INSTANT PURCHASE","rules":[{"type":"GENERAL INFORMATION","text":"RU.RULE APPLICATION FOR GS6NZCTG TYPE FARES STANDARD FARE APPLICATION CLASS OF SERVICE THESE FARES APPLY FOR ECONOMY CLASS SERVICE. CAPACITY LIMITATIONS CARRIER SHALL LIMIT THE NUMBER OF PASSENGERS CARRIED ON ANY ONE FLIGHT AT FARES GOVERNED BY RULES MAKING REFERENCE HERETO AND SUCH FARES WILL NOT NECESSARILY BE AVAILABLE ON ALL FLIGHTS OPERATED BY THE CARRIER.  THE NUMBER OF SEATS WHICH THE CARRIER SHALL MAKE AVAILABLE ON A GIVEN FLIGHT WILL BE DETERMINED BY THE CARRIERS BEST JUDGEMENT AS TO THE ANTICIPATED TOTAL PASSENGER LOAD ON EACH FLIGHT. RULES NOT APPLICABLE 165/170/175 OTHER CONDITIONS WAITLISTING IS NOT PERMITTED. SE.SEASONS NONE UNLESS OTHERWISE SPECIFIED DA.DAY/TIME NONE UNLESS OTHERWISE SPECIFIED SR.SALES RESTRICT \nTICKETS MUST BE ISSUED ON/BEFORE 21NOV 26. \nSALE IS RESTRICTED TO SPECIFIC AGENTS. TICKETS MAY BE ISSUED BY ELECTRONIC TICKETING. NOTE - -PAPER TICKET MAY BE ISSUED FOR OAL CARRIERS NOT INVOLVED IN E TICKETING WITH AC. -PAPER TICKET MAY BE ISSUED FOR ITINERARIES WHERE ELECTRONIC TICKETING IS NOT SUPPORTED. OR - SALE IS RESTRICTED TO SPECIFIC AGENTS. TICKETS MAY BE ISSUED BY ELECTRONIC TICKETING. NOTE - -PAPER TICKET MAY BE ISSUED FOR OAL CARRIERS NOT INVOLVED IN E TICKETING WITH AC. -PAPER TICKET MAY BE ISSUED FOR ITINERARIES WHERE ELECTRONIC TICKETING IS NOT SUPPORTED. OR - TICKETS MUST BE ISSUED BY ELECTRONIC TICKETING. TICKETS MAY NOT BE SOLD IN VENEZUELA. TICKETS MAY ONLY BE SOLD IN AREA 1/AREA 2/AREA 3. NOTE - -PAPER TICKET MAY BE ISSUED FOR OAL CARRIERS NOT INVOLVED IN E TICKETING WITH AC. -PAPER TICKET MAY BE ISSUED FOR ITINERARIES WHERE ELECTRONIC TICKETING IS NOT SUPPORTED. *** GENERAL RULE FOLLOWS *** \nTICKETS MUST BE ISSUED BY ELECTRONIC TICKETING. TICKETS MAY NOT BE SOLD IN IRAN,ISLAMIC REPUBLIC OF/ VENEZUELA/EGYPT/SOUTH SUDAN/SUDAN/NIGERIA/ANGOLA. TICKETS MAY ONLY BE SOLD IN AREA 1/AREA 2/AREA 3. NOTE - EXTENSION OF TICKET VALIDITY PERMITTED UNDER GUIDELINES SET FORTH BY CARRIER.  CONTACT CARRIER FOR DETAILS. TR.TVL RESTRICTION \nVALID FOR TRAVEL COMMENCING ON EACH TRIP ON/AFTER 19DEC 26. TRAVEL ON THIS FARE COMPONENT MUST COMMENCE BY MIDNIGHT ON 31JAN 27. AP.ADVANCE RES/TKT FOR ONE WAY GS6NZCTG TYPE FARES \nRESERVATIONS FOR ALL SECTORS ARE REQUIRED AT LEAST 30 DAYS BEFORE DEPARTURE. WAITLIST AND STANDBY NOT PERMITTED. TICKETING MUST BE COMPLETED WITHIN 24 HOURS AFTER RESERVATIONS ARE MADE OR AT LEAST 30 DAYS BEFORE DEPARTURE WHICHEVER IS EARLIER. NOTE - OPEN SEGMENTS NOT PERMITTED. -------------------------------------------------- DUE TO AUTOMATED TICKETING DEADLINE CONTROL DIFFERENCES COULD EXIST BETWEEN THE FARE RULE LAST TICKETING DATE AND THE FLIGHT FIRMING GENERATED TICKETING DEADLINE MESSAGE - THE MOST RESTRICTIVE TICKETING DEADLINE APPLIES. CD.CHILD DISCOUNTS \n1ST INFANT UNDER 2 WITHOUT A SEAT - NO CHARGE TICKET DESIGNATOR - IN. MUST BE ACCOMPANIED ON ALL FLIGHTS IN SAME COMPARTMENT BY ADULT 16 OR OLDER OR - 1ST INFANT UNDER 2 WITH A SEAT - CHARGE 100 PERCENT OF THE FARE. TICKET DESIGNATOR - CH. MUST BE ACCOMPANIED ON ALL FLIGHTS IN SAME COMPARTMENT BY ADULT 16 OR OLDER OR - ACCOMPANIED CHILD 2-11 - CHARGE 100 PERCENT OF THE FARE. TICKET DESIGNATOR - CH. MUST BE ACCOMPANIED ON ALL FLIGHTS IN SAME COMPARTMENT BY ADULT 16 OR OLDER OR - UNACCOMPANIED CHILD 8-17 - CHARGE 100 PERCENT OF THE FARE. TICKET DESIGNATOR - CH. TC.TOUR CONDUCTOR NONE UNLESS OTHERWISE SPECIFIED AD.AGTS DISCOUNTS NONE UNLESS OTHERWISE SPECIFIED OD.OTHER DISCOUNTS \nNOTE - CONTACT CARRIER FOR FURTHER INFOS SO.STOPOVERS FROM/TO CANADA \nIF THE FARE COMPONENT IS ON ONE OR MORE OF THE FOLLOWING ANY AC FLIGHT NO STOPOVERS PERMITTED. NO STOPOVER OCCURS IF PASSENGER TAKES NEXT AVAILABLE FLIGHT WITHIN 10 HOURS. SU.SURCHARGES BETWEEN YVR AND CANADA FOR GS6NZCTG TYPE FARES \nIF INFANT UNDER 02 WITHOUT A SEAT. THERE IS NO CHARGE FOR TRAVEL. \nTHE PROVISIONS BELOW APPLY ONLY AS FOLLOWS - TICKETS MAY ONLY BE SOLD IN CANADA/THE UNITED STATES. OR - FARES MAY ONLY BE SOLD BY AC . TICKETS MUST BE ISSUED ON AC . OR - SALE IS RESTRICTED TO SPECIFIC AGENTS. TICKETS MUST BE ISSUED ON AC A SURCHARGE OF CAD 3.00 WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL. NOTE - THIS IS AN INSURANCE SURCHARGE.  THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 42.00 WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL. NOTE - THIS IS A NAVIGATION SURCHARGE. THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 18DEC 26 THROUGH 23DEC 26. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 26DEC 26 THROUGH 31DEC 26. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 01JAN 27 THROUGH 05JAN 27. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 08JAN 27 THROUGH 10JAN 27. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. \nAND - FROM YVR - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND ONTARIO. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND QUEBEC (ATPCO). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND QUEBEC (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NOVA SCOTIA. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NEW BRUNSWICK. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND PRINCE EDWARD ISLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NEWFOUNDLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NEWFOUNDLAND AND LABRADOR (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND ONTARIO. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND QUEBEC (ATPCO). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND QUEBEC (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NOVA SCOTIA. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NEW BRUNSWICK. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND PRINCE EDWARD ISLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NEWFOUNDLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NEWFOUNDLAND AND LABRADOR (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. \nTHE PROVISIONS BELOW APPLY ONLY AS FOLLOWS - TICKETS MAY NOT BE SOLD IN CANADA/THE UNITED STATES. A SURCHARGE OF CAD 3.00 WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL. NOTE - THIS IS AN INSURANCE SURCHARGE.  THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 42.00 WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL. NOTE - THIS IS A NAVIGATION SURCHARGE. THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 18DEC 26 THROUGH 23DEC 26. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 26DEC 26 THROUGH 31DEC 26. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 01JAN 27 THROUGH 05JAN 27. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 08JAN 27 THROUGH 10JAN 27. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. \nAND - FROM YVR - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND ONTARIO. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND QUEBEC (ATPCO). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND QUEBEC (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NOVA SCOTIA. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NEW BRUNSWICK. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND PRINCE EDWARD ISLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NEWFOUNDLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NEWFOUNDLAND AND LABRADOR (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND ONTARIO. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND QUEBEC (ATPCO). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND QUEBEC (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NOVA SCOTIA. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NEW BRUNSWICK. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND PRINCE EDWARD ISLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NEWFOUNDLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NEWFOUNDLAND AND LABRADOR (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. \nAND - A SURCHARGE OF CAD 10.00 WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL. NOTE - THIS IS A TICKETING SURCHARGE.  THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. CO.COMBINABILITY APPLICABLE ADD-ON CONSTRUCTION IS ADDRESSED IN MISCELLANEOUS PROVISIONS - CATEGORY 23. OPEN JAWS FARES MAY BE COMBINED ON A HALF ROUND TRIP BASIS -TO FORM SINGLE OR DOUBLE OPEN JAWS. PROVIDED - WHEN THE OPEN SEGMENT OCCURS -WITHIN AREA 1 COMBINATIONS ARE WITH ANY FARE FOR CARRIER AC/UA/5T/ P6/ZX IN ANY RULE AND TARIFF. OPEN JAWS FARES MAY BE COMBINED ON A HALF ROUND TRIP BASIS -TO FORM SINGLE OR DOUBLE OPEN JAWS. PROVIDED - WHEN THE OPEN SEGMENT OCCURS -WITHIN AREA 1 COMBINATIONS ARE WITH ANY FARE FOR CARRIER PB IN RULE PBST IN TARIFF CDR     - WITHIN CANADA. 2-COMPONENT CIRCLE TRIPS/MULTI-COMPONENT CIRCLE TRIPS FARES MAY BE COMBINED ON A HALF ROUND TRIP BASIS -TO FORM 2-COMPONENT CIRCLE TRIPS/MULTI-COMPONENT CIRCLE TRIPS. PROVIDED - COMBINATIONS ARE WITH ANY FARE FOR CARRIER AC/UA/5T/P6/ ZX IN ANY RULE AND TARIFF. 2-COMPONENT CIRCLE TRIPS/MULTI-COMPONENT CIRCLE TRIPS FARES MAY BE COMBINED ON A HALF ROUND TRIP BASIS -TO FORM 2-COMPONENT CIRCLE TRIPS/MULTI-COMPONENT CIRCLE TRIPS. PROVIDED - COMBINATIONS ARE WITH ANY FARE FOR CARRIER PB IN RULE PBST IN TARIFF CDR     - WITHIN CANADA. END-ON-END END-ON-END COMBINATIONS PERMITTED. VALIDATE ALL FARE COMPONENTS. SIDE TRIPS PERMITTED. PROVIDED - COMBINATIONS ARE NOT FOR CARRIER WS/AF/AZ/DL/KL/VS/AT/ EK/EY/TK/NZ/PK/FJ/PR END-ON-END END-ON-END COMBINATIONS PERMITTED. VALIDATE ALL FARE COMPONENTS. SIDE TRIPS PERMITTED. PROVIDED - COMBINATIONS ARE NOT FOR CARRIER PB IN RULE ATST/PBBA/ PBFL/PBPR/PB00/1000/1100/2000/4460/4900 IN TARIFF CDR     - WITHIN CANADA. OTHERWISE END-ON-END COMBINATIONS PERMITTED. VALIDATE ALL FARE COMPONENTS. FARES MUST BE SHOWN SEPARATELY ON THE TICKET. TRAVEL MUST BE VIA THE POINT OF COMBINATION. SIDE TRIPS PERMITTED. NOTE - THE CITY PAIRS BELOW ARE CONSIDERED THE SAME POINT- YYZ-YTZ MD.MISCELLANEOUS DATA NONE UNLESS OTHERWISE SPECIFIED VC.VOLUNTARY CHANGES VOLUNTARY CHANGES CONDITIONS MAY APPLY FOR AUTOMATED REISSUE/REVALIDATION REFER TO PENALTIES CATEGORY *PE FOR DETAILS \nVR.VOLUNTARY REFUNDS VOLUNTARY CHANGES CONDITIONS MAY APPLY FOR AUTOMATED REFUNDS REFER TO PENALTIES CATEGORY *PE FOR DETAILS \n\n"},{"type":"TICKET ENDORSMENT","text":"TE.TKT ENDORSEMENT \nTHE ORIGINAL TICKET MUST BE ANNOTATED - AC ONLY/CHG FEE/ NON REF - IN THE ENDORSEMENT BOX. "},{"type":"PENALTIES","text":"PE.PENALTIES FOR ONE WAY GS6NZCTG TYPE FARES \nCANCELLATIONS \nTICKET IS NON-REFUNDABLE IN CASE OF CANCEL/NO-SHOW/ REFUND. NOTE - TICKET/VALIDITY FORFEIT POLICY- FLIGHT SEGMENT OR SEGMENTS MUST BE CANCELLED ON OR PRIOR TO ORIGINAL DEPARTURE DATE. FAILURE TO CANCEL FLIGHT SEGMENT OR SEGMENTS PRIOR TO DEPARTURE DATE WILL RESULT IN COUPON OR COUPONS FORFEIT AND COUPON WILL HAVE NO VALUE. -------------------------------------------------- WAIVED FOR THE DEATH OF THE PASSENGER OR PASSENGER FAMILY MEMBER OR PASSENGERS TRAVELLING COMPANION. DOCUMENTATION REQUIRED. IN THE EVENT PSGRS ARE CALLED TO JURY DUTY OR ARE SUBPOENAED FULL REFUND WILL APPLY UPON PRESENTATION OF JURY SUMMONS OR SUBPOENA PROVIDED FLIGHT SEGMENTS ARE CANCELLED PRIOR TO TICKETED DEPARTURE DATE. ------------------------------------------------- EFFECTIVE FOR CHANGES MADE AFTER 06JUNE 2023 PASSENGER CAN MAINTAIN UNUSED VALUE OF TICKET AS A CREDIT SUBJECT TO THE CHANGE FEE OF THE FARE RULE CONTAINED HEREIN. REFERENCE GENERAL RULE 80 AND 85.  MUST BE DONE VIA AIRCANADA.COM OR THROUGH AC CONTACT CENTER.  MUST BE ON 014 TICKET STOCK \nCHANGES \nANY TIME CHARGE CAD 100.00 FOR REISSUE/REVALIDATION. NOTE - CHANGES NOT PERMITTED IN CASE OF NO- SHOW. -------------------------------------------------- STANDARD TICKET/VALIDITY FORFEIT POLICY- FLIGHT SEGMENT OR SEGMENTS MUST BE CANCELLED ON OR PRIOR TO ORIGINAL DEPARTURE DATE. FAILURE TO CANCEL FLIGHT SEGMENT OR SEGMENTS PRIOR TO DEPARTURE DATE WILL RESULT IN COUPON OR COUPONS FORFEIT AND COUPON WILL HAVE NO VALUE. FULLY UNUSED TICKETS MAY BE REBOOKED AND TRAVEL COMPLETED UP TO ONE YEAR FROM ORIGINAL ISSUE DATE. PARTIALLY USED TICKET MAY BE REBOOKED AND TRAVEL COMPLETED UP TO ONE YEAR FROM ORIGINAL OUTBOUND DATE. -------------------------------------------------- WAIVED FOR THE DEATH OF THE PASSENGER OR PASSENGER FAMILY MEMBER OR PASSENGERS TRAVELLING COMPANION. DOCUMENTATION REQUIRED. IN THE EVENT PSGRS ARE CALLED TO JURY DUTY OR ARE SUBPOENAED FULL REFUND WILL APPLY UPON PRESENTATION OF JURY SUMMONS OR SUBPOENA PROVIDED FLIGHT SEGMENTS ARE CANCELLED PRIOR TO TICKETED DEPARTURE DATE. -------------------------------------------------- REPRICE USING ANY FARE TYPE EXCEPT ERU/EOU/ZOU/ZRU/BOU/BRU USED FOR BASIC BRAND. -------------------------------------------------- CHANGE FEE APPLIES PER FARE COMPONENT. -------------------------------------------------- VOLUNTARY CHANGES FOR ANY FLIGHT SEGMENT MUST BE IN ACCORDANCE WITH THE FOLLOWING- A. THE NEW FLIGHT SEGMENT MUST BE REPRICED AND REISSUED WITH CURRENT AND APPLICABLE FARE. B. IF THE NEW FLIGHT SEGMENT IS OF EQUAL OR HIGHER VALUE THE FARE DIFFERENCE MUST BE PAID. C. FLIGHT COUPONS MUST BE USED IN SEQUENCE. CHANGES IN THE SEQUENCE OF ANY FLIGHT COUPON WILL RESULT IN A TICKET REISSUE. -PLEASE NOTE- IF A FARE IS COMBINED WITH HALF A ROUND TRIP FARE IN A CIRCLE TRIP - THE HIGHEST CHANGE FEE AND THE MOST RESTRICTIVE FARE RULE APPLIES TO THE ENTIRE TICKET. -------------------------------------------------- AIRPORT SAME DAY CONFIRMED CHANGE FEE- ON STANDARD -TG TYPE FARES PASSENGERS HOLDING CONFIRMED RESERVATIONS AND TICKETS MAY CONFIRM EARLIER/LATER SAME DAY FLIGHTS BETWEEN THE SAME ORIGIN/DESTINATION/STOPOVER POINTS FOR A NONREFUNDABLE FEE OF CAD100/USD100. FOR ROUTES BETWEEN YOW/YMQ-YTO AND BETWEEN YYC/YEA/YVR ON STANDARD -TG TYPE FARES PASSENGERS HOLDING CONFIRMED RESERVATIONS AND TICKETS MAY STANDBY FOR EARLIER SAME DAY FLIGHTS BETWEEN THE SAME ORIGIN/DESTINATION AT NO CHARGE. NOTE- A. SEAT INVENTORY MUST BE AVAILABLE IN THE CABIN APPLICABLE TO THE FARE CHARGED. B. POLICY APPLIES FOR PASSENGERS NEXT OUTBOUND OR INBOUND ONLY. CHANGES CANNOT BE MADE TO INBOUND SEGMENTS BEFORE THE ORIGINAL TICKETED OUTBOUND HAS BEEN FLOWN. C. CONFIRMED CHANGE MAY ONLY BE MADE AT THE AIRPORT ON THE DAY OF THE FLIGHT AND PRIOR TO THE ORIGINAL DEPARTURE TIME. D. REGULAR FARE RULES APPLY - CHANGE FEES/ADCOL- FOR ANY CHANGES WHICH DO NOT QUALIFY FOR THE AIRPORT SAME DAY CONFIRMED CHANGE FEE. E. SAMEDAY STANDBY NOT ALLOWED EXCEPT FOR STANDARD TYPE FARES BETWEEN YOW/YMQ-YTO AND BETWEEN YYC/YEA/YVR AS NOTED ABOVE. -------------------------------------------------- TICKET UPGRADE - PASSENGERS UPGRADING TO A BUSINESS CLASS FARE /EXCEPT BASIC/ OR PREMIUM ECONOMY FARES/EXCEPT BASIC / WILL NOT BE ASSESSED THE CHANGE FEE. ALL OTHER RULES MUST BE MET. ANY NONREFUNDABLE AMOUNT REMAINS NONREFUNDABLE. -------------------------------------------------- CHANGE FEES ARE SUBJECT TO THE SAME TAXES AS THE ORIGINAL TICKET. "}]}],"bagOptions":[],"extras":{"seats":[{"travelerId":"1","segmentId":"6","seatNumber":"18C"}],"bags":[]},"bookingRequirements":{"emailAddressRequired":true,"mobilePhoneNumberRequired":true,"travelerRequirements":[{"travelerId":"1","genderRequired":true,"dateOfBirthRequired":true,"redressRequiredIfAny":true,"residenceRequired":true}]},"holdAllowed":{"allowed":true,"reason":null}},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/flights/priced-offers/{pricedOfferId}/extras":{"post":{"operationId":"addExtras","tags":["Shopping"],"summary":"Add seats and bags","description":"Add seats and bags: re-prices the offer with paid seats (from its seat map) and extra checked bags. The answer is the priced offer at the new total — book with that total. Sending the call again replaces the previous choice; send an empty body to remove the extras.","x-scope":"flights:search","x-try-it":false,"x-errors":[{"status":404,"code":"PRICED_OFFER_EXPIRED","when":"The priced offer is unknown or expired. Price the offer again.","example":{"error":{"code":"PRICED_OFFER_EXPIRED","message":"This priced offer is unknown or expired. Price the offer again.","requestId":"ca6ed9d1-86ed-43df-8646-6427b9f8e944"}}},{"status":400,"code":"UNKNOWN_TRAVELER","when":"A `travelerId` is not on the offer (use `offer.fares[].travelerId`).","example":{"error":{"code":"UNKNOWN_TRAVELER","message":"Traveller \"9\" is not on this offer. Use the travelerId values of offer.fares.","requestId":"50dc5355-c26a-48d6-b1f3-4db53bafbd4b"}}},{"status":422,"code":"EXTRAS_REFUSED","when":"The airline did not accept the seat or bag.","example":{"error":{"code":"EXTRAS_REFUSED","message":"Seat 99Z was requested on a flight that is not part of this booking.","requestId":"cf1abf0f-650e-4db8-a001-a23b9ea8764a"}}}],"parameters":[{"name":"pricedOfferId","in":"path","required":true,"description":"`pricedOfferId` from Price an offer.","schema":{"type":"string","description":"Priced offer id.","maxLength":64},"example":"4837aa60-c394-43fa-b4d9-bc306f3a9a1b"},{"$ref":"#/components/parameters/RequestId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtrasRequest"},"example":{"seats":[{"travelerId":"1","segmentId":"6","seatNumber":"18C"}]}}}},"responses":{"200":{"description":"The priced offer with the extras.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricedOfferWithExtras"},"example":{"pricedOfferId":"4837aa60-c394-43fa-b4d9-bc306f3a9a1b","expiresAt":"2026-11-18T15:31:13.531Z","offer":{"offerId":"4837aa60-c394-43fa-b4d9-bc306f3a9a1b","groupId":"priced","validatingCarrier":"AC","lastTicketingDate":"2026-11-19","seatsAvailable":null,"price":{"currency":"USD","total":"350.20","base":"280.50","taxes":"69.70"},"itineraries":[{"duration":null,"segments":[{"id":"6","carrier":"AC","flightNumber":"125","operatingCarrier":"AC","from":{"airport":"YYZ","terminal":"1","at":"2027-01-17T20:20:00"},"to":{"airport":"YVR","terminal":"M","at":"2027-01-17T23:22:00"},"duration":"PT5H2M","aircraft":"789","stops":0}]}],"fares":[{"travelerId":"1","travelerType":"ADULT","total":"229.70","segments":[{"segmentId":"6","cabin":"ECONOMY","bookingClass":"G","fareBasis":"GS6NZCTG","brand":"STANDARD","brandLabel":null,"checkedBags":{"quantity":0,"weight":null,"weightUnit":null},"cabinBags":{"quantity":1,"weight":null,"weightUnit":null}}]}]},"penalties":[{"type":"CANCELLATION","label":"Cancellation fee","amount":null,"currency":"USD","applicable":false},{"type":"CHANGE","label":"Change fee","amount":70,"currency":"USD","applicable":true}],"fareRules":[{"fareComponent":"1","segmentId":"6","fareBasis":"GS6NZCTG","name":"ONEWAY INSTANT PURCHASE","rules":[{"type":"GENERAL INFORMATION","text":"RU.RULE APPLICATION FOR GS6NZCTG TYPE FARES STANDARD FARE APPLICATION CLASS OF SERVICE THESE FARES APPLY FOR ECONOMY CLASS SERVICE. CAPACITY LIMITATIONS CARRIER SHALL LIMIT THE NUMBER OF PASSENGERS CARRIED ON ANY ONE FLIGHT AT FARES GOVERNED BY RULES MAKING REFERENCE HERETO AND SUCH FARES WILL NOT NECESSARILY BE AVAILABLE ON ALL FLIGHTS OPERATED BY THE CARRIER.  THE NUMBER OF SEATS WHICH THE CARRIER SHALL MAKE AVAILABLE ON A GIVEN FLIGHT WILL BE DETERMINED BY THE CARRIERS BEST JUDGEMENT AS TO THE ANTICIPATED TOTAL PASSENGER LOAD ON EACH FLIGHT. RULES NOT APPLICABLE 165/170/175 OTHER CONDITIONS WAITLISTING IS NOT PERMITTED. SE.SEASONS NONE UNLESS OTHERWISE SPECIFIED DA.DAY/TIME NONE UNLESS OTHERWISE SPECIFIED SR.SALES RESTRICT \nTICKETS MUST BE ISSUED ON/BEFORE 21NOV 26. \nSALE IS RESTRICTED TO SPECIFIC AGENTS. TICKETS MAY BE ISSUED BY ELECTRONIC TICKETING. NOTE - -PAPER TICKET MAY BE ISSUED FOR OAL CARRIERS NOT INVOLVED IN E TICKETING WITH AC. -PAPER TICKET MAY BE ISSUED FOR ITINERARIES WHERE ELECTRONIC TICKETING IS NOT SUPPORTED. OR - SALE IS RESTRICTED TO SPECIFIC AGENTS. TICKETS MAY BE ISSUED BY ELECTRONIC TICKETING. NOTE - -PAPER TICKET MAY BE ISSUED FOR OAL CARRIERS NOT INVOLVED IN E TICKETING WITH AC. -PAPER TICKET MAY BE ISSUED FOR ITINERARIES WHERE ELECTRONIC TICKETING IS NOT SUPPORTED. OR - TICKETS MUST BE ISSUED BY ELECTRONIC TICKETING. TICKETS MAY NOT BE SOLD IN VENEZUELA. TICKETS MAY ONLY BE SOLD IN AREA 1/AREA 2/AREA 3. NOTE - -PAPER TICKET MAY BE ISSUED FOR OAL CARRIERS NOT INVOLVED IN E TICKETING WITH AC. -PAPER TICKET MAY BE ISSUED FOR ITINERARIES WHERE ELECTRONIC TICKETING IS NOT SUPPORTED. *** GENERAL RULE FOLLOWS *** \nTICKETS MUST BE ISSUED BY ELECTRONIC TICKETING. TICKETS MAY NOT BE SOLD IN IRAN,ISLAMIC REPUBLIC OF/ VENEZUELA/EGYPT/SOUTH SUDAN/SUDAN/NIGERIA/ANGOLA. TICKETS MAY ONLY BE SOLD IN AREA 1/AREA 2/AREA 3. NOTE - EXTENSION OF TICKET VALIDITY PERMITTED UNDER GUIDELINES SET FORTH BY CARRIER.  CONTACT CARRIER FOR DETAILS. TR.TVL RESTRICTION \nVALID FOR TRAVEL COMMENCING ON EACH TRIP ON/AFTER 19DEC 26. TRAVEL ON THIS FARE COMPONENT MUST COMMENCE BY MIDNIGHT ON 31JAN 27. AP.ADVANCE RES/TKT FOR ONE WAY GS6NZCTG TYPE FARES \nRESERVATIONS FOR ALL SECTORS ARE REQUIRED AT LEAST 30 DAYS BEFORE DEPARTURE. WAITLIST AND STANDBY NOT PERMITTED. TICKETING MUST BE COMPLETED WITHIN 24 HOURS AFTER RESERVATIONS ARE MADE OR AT LEAST 30 DAYS BEFORE DEPARTURE WHICHEVER IS EARLIER. NOTE - OPEN SEGMENTS NOT PERMITTED. -------------------------------------------------- DUE TO AUTOMATED TICKETING DEADLINE CONTROL DIFFERENCES COULD EXIST BETWEEN THE FARE RULE LAST TICKETING DATE AND THE FLIGHT FIRMING GENERATED TICKETING DEADLINE MESSAGE - THE MOST RESTRICTIVE TICKETING DEADLINE APPLIES. CD.CHILD DISCOUNTS \n1ST INFANT UNDER 2 WITHOUT A SEAT - NO CHARGE TICKET DESIGNATOR - IN. MUST BE ACCOMPANIED ON ALL FLIGHTS IN SAME COMPARTMENT BY ADULT 16 OR OLDER OR - 1ST INFANT UNDER 2 WITH A SEAT - CHARGE 100 PERCENT OF THE FARE. TICKET DESIGNATOR - CH. MUST BE ACCOMPANIED ON ALL FLIGHTS IN SAME COMPARTMENT BY ADULT 16 OR OLDER OR - ACCOMPANIED CHILD 2-11 - CHARGE 100 PERCENT OF THE FARE. TICKET DESIGNATOR - CH. MUST BE ACCOMPANIED ON ALL FLIGHTS IN SAME COMPARTMENT BY ADULT 16 OR OLDER OR - UNACCOMPANIED CHILD 8-17 - CHARGE 100 PERCENT OF THE FARE. TICKET DESIGNATOR - CH. TC.TOUR CONDUCTOR NONE UNLESS OTHERWISE SPECIFIED AD.AGTS DISCOUNTS NONE UNLESS OTHERWISE SPECIFIED OD.OTHER DISCOUNTS \nNOTE - CONTACT CARRIER FOR FURTHER INFOS SO.STOPOVERS FROM/TO CANADA \nIF THE FARE COMPONENT IS ON ONE OR MORE OF THE FOLLOWING ANY AC FLIGHT NO STOPOVERS PERMITTED. NO STOPOVER OCCURS IF PASSENGER TAKES NEXT AVAILABLE FLIGHT WITHIN 10 HOURS. SU.SURCHARGES BETWEEN YVR AND CANADA FOR GS6NZCTG TYPE FARES \nIF INFANT UNDER 02 WITHOUT A SEAT. THERE IS NO CHARGE FOR TRAVEL. \nTHE PROVISIONS BELOW APPLY ONLY AS FOLLOWS - TICKETS MAY ONLY BE SOLD IN CANADA/THE UNITED STATES. OR - FARES MAY ONLY BE SOLD BY AC . TICKETS MUST BE ISSUED ON AC . OR - SALE IS RESTRICTED TO SPECIFIC AGENTS. TICKETS MUST BE ISSUED ON AC A SURCHARGE OF CAD 3.00 WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL. NOTE - THIS IS AN INSURANCE SURCHARGE.  THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 42.00 WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL. NOTE - THIS IS A NAVIGATION SURCHARGE. THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 18DEC 26 THROUGH 23DEC 26. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 26DEC 26 THROUGH 31DEC 26. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 01JAN 27 THROUGH 05JAN 27. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 08JAN 27 THROUGH 10JAN 27. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. \nAND - FROM YVR - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND ONTARIO. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND QUEBEC (ATPCO). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND QUEBEC (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NOVA SCOTIA. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NEW BRUNSWICK. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND PRINCE EDWARD ISLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NEWFOUNDLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NEWFOUNDLAND AND LABRADOR (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND ONTARIO. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND QUEBEC (ATPCO). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND QUEBEC (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NOVA SCOTIA. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NEW BRUNSWICK. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND PRINCE EDWARD ISLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NEWFOUNDLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NEWFOUNDLAND AND LABRADOR (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. \nTHE PROVISIONS BELOW APPLY ONLY AS FOLLOWS - TICKETS MAY NOT BE SOLD IN CANADA/THE UNITED STATES. A SURCHARGE OF CAD 3.00 WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL. NOTE - THIS IS AN INSURANCE SURCHARGE.  THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 42.00 WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL. NOTE - THIS IS A NAVIGATION SURCHARGE. THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 18DEC 26 THROUGH 23DEC 26. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 26DEC 26 THROUGH 31DEC 26. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 01JAN 27 THROUGH 05JAN 27. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 30.00 WILL BE ADDED TO THE APPLICABLE FARE FOR PEAK TRAVEL FROM 08JAN 27 THROUGH 10JAN 27. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. \nAND - FROM YVR - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND ONTARIO. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND QUEBEC (ATPCO). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND QUEBEC (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NOVA SCOTIA. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NEW BRUNSWICK. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND PRINCE EDWARD ISLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NEWFOUNDLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YLW/YYJ AND NEWFOUNDLAND AND LABRADOR (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND ONTARIO. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND QUEBEC (ATPCO). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND QUEBEC (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NOVA SCOTIA. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NEW BRUNSWICK. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND PRINCE EDWARD ISLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NEWFOUNDLAND. NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. AND - A SURCHARGE OF CAD 40.00 PER FARE COMPONENT WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL FOR A PORTION OF TRAVEL BETWEEN YCD AND NEWFOUNDLAND AND LABRADOR (IATA). NOTE - THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. \nAND - A SURCHARGE OF CAD 10.00 WILL BE ADDED TO THE APPLICABLE FARE FOR TRAVEL. NOTE - THIS IS A TICKETING SURCHARGE.  THE SURCHARGE APPLIES IN ADDITION TO ALL OTHER CHARGES AND IS NOT SUBJECT TO ANY DISCOUNT. CO.COMBINABILITY APPLICABLE ADD-ON CONSTRUCTION IS ADDRESSED IN MISCELLANEOUS PROVISIONS - CATEGORY 23. OPEN JAWS FARES MAY BE COMBINED ON A HALF ROUND TRIP BASIS -TO FORM SINGLE OR DOUBLE OPEN JAWS. PROVIDED - WHEN THE OPEN SEGMENT OCCURS -WITHIN AREA 1 COMBINATIONS ARE WITH ANY FARE FOR CARRIER AC/UA/5T/ P6/ZX IN ANY RULE AND TARIFF. OPEN JAWS FARES MAY BE COMBINED ON A HALF ROUND TRIP BASIS -TO FORM SINGLE OR DOUBLE OPEN JAWS. PROVIDED - WHEN THE OPEN SEGMENT OCCURS -WITHIN AREA 1 COMBINATIONS ARE WITH ANY FARE FOR CARRIER PB IN RULE PBST IN TARIFF CDR     - WITHIN CANADA. 2-COMPONENT CIRCLE TRIPS/MULTI-COMPONENT CIRCLE TRIPS FARES MAY BE COMBINED ON A HALF ROUND TRIP BASIS -TO FORM 2-COMPONENT CIRCLE TRIPS/MULTI-COMPONENT CIRCLE TRIPS. PROVIDED - COMBINATIONS ARE WITH ANY FARE FOR CARRIER AC/UA/5T/P6/ ZX IN ANY RULE AND TARIFF. 2-COMPONENT CIRCLE TRIPS/MULTI-COMPONENT CIRCLE TRIPS FARES MAY BE COMBINED ON A HALF ROUND TRIP BASIS -TO FORM 2-COMPONENT CIRCLE TRIPS/MULTI-COMPONENT CIRCLE TRIPS. PROVIDED - COMBINATIONS ARE WITH ANY FARE FOR CARRIER PB IN RULE PBST IN TARIFF CDR     - WITHIN CANADA. END-ON-END END-ON-END COMBINATIONS PERMITTED. VALIDATE ALL FARE COMPONENTS. SIDE TRIPS PERMITTED. PROVIDED - COMBINATIONS ARE NOT FOR CARRIER WS/AF/AZ/DL/KL/VS/AT/ EK/EY/TK/NZ/PK/FJ/PR END-ON-END END-ON-END COMBINATIONS PERMITTED. VALIDATE ALL FARE COMPONENTS. SIDE TRIPS PERMITTED. PROVIDED - COMBINATIONS ARE NOT FOR CARRIER PB IN RULE ATST/PBBA/ PBFL/PBPR/PB00/1000/1100/2000/4460/4900 IN TARIFF CDR     - WITHIN CANADA. OTHERWISE END-ON-END COMBINATIONS PERMITTED. VALIDATE ALL FARE COMPONENTS. FARES MUST BE SHOWN SEPARATELY ON THE TICKET. TRAVEL MUST BE VIA THE POINT OF COMBINATION. SIDE TRIPS PERMITTED. NOTE - THE CITY PAIRS BELOW ARE CONSIDERED THE SAME POINT- YYZ-YTZ MD.MISCELLANEOUS DATA NONE UNLESS OTHERWISE SPECIFIED VC.VOLUNTARY CHANGES VOLUNTARY CHANGES CONDITIONS MAY APPLY FOR AUTOMATED REISSUE/REVALIDATION REFER TO PENALTIES CATEGORY *PE FOR DETAILS \nVR.VOLUNTARY REFUNDS VOLUNTARY CHANGES CONDITIONS MAY APPLY FOR AUTOMATED REFUNDS REFER TO PENALTIES CATEGORY *PE FOR DETAILS \n\n"},{"type":"TICKET ENDORSMENT","text":"TE.TKT ENDORSEMENT \nTHE ORIGINAL TICKET MUST BE ANNOTATED - AC ONLY/CHG FEE/ NON REF - IN THE ENDORSEMENT BOX. "},{"type":"PENALTIES","text":"PE.PENALTIES FOR ONE WAY GS6NZCTG TYPE FARES \nCANCELLATIONS \nTICKET IS NON-REFUNDABLE IN CASE OF CANCEL/NO-SHOW/ REFUND. NOTE - TICKET/VALIDITY FORFEIT POLICY- FLIGHT SEGMENT OR SEGMENTS MUST BE CANCELLED ON OR PRIOR TO ORIGINAL DEPARTURE DATE. FAILURE TO CANCEL FLIGHT SEGMENT OR SEGMENTS PRIOR TO DEPARTURE DATE WILL RESULT IN COUPON OR COUPONS FORFEIT AND COUPON WILL HAVE NO VALUE. -------------------------------------------------- WAIVED FOR THE DEATH OF THE PASSENGER OR PASSENGER FAMILY MEMBER OR PASSENGERS TRAVELLING COMPANION. DOCUMENTATION REQUIRED. IN THE EVENT PSGRS ARE CALLED TO JURY DUTY OR ARE SUBPOENAED FULL REFUND WILL APPLY UPON PRESENTATION OF JURY SUMMONS OR SUBPOENA PROVIDED FLIGHT SEGMENTS ARE CANCELLED PRIOR TO TICKETED DEPARTURE DATE. ------------------------------------------------- EFFECTIVE FOR CHANGES MADE AFTER 06JUNE 2023 PASSENGER CAN MAINTAIN UNUSED VALUE OF TICKET AS A CREDIT SUBJECT TO THE CHANGE FEE OF THE FARE RULE CONTAINED HEREIN. REFERENCE GENERAL RULE 80 AND 85.  MUST BE DONE VIA AIRCANADA.COM OR THROUGH AC CONTACT CENTER.  MUST BE ON 014 TICKET STOCK \nCHANGES \nANY TIME CHARGE CAD 100.00 FOR REISSUE/REVALIDATION. NOTE - CHANGES NOT PERMITTED IN CASE OF NO- SHOW. -------------------------------------------------- STANDARD TICKET/VALIDITY FORFEIT POLICY- FLIGHT SEGMENT OR SEGMENTS MUST BE CANCELLED ON OR PRIOR TO ORIGINAL DEPARTURE DATE. FAILURE TO CANCEL FLIGHT SEGMENT OR SEGMENTS PRIOR TO DEPARTURE DATE WILL RESULT IN COUPON OR COUPONS FORFEIT AND COUPON WILL HAVE NO VALUE. FULLY UNUSED TICKETS MAY BE REBOOKED AND TRAVEL COMPLETED UP TO ONE YEAR FROM ORIGINAL ISSUE DATE. PARTIALLY USED TICKET MAY BE REBOOKED AND TRAVEL COMPLETED UP TO ONE YEAR FROM ORIGINAL OUTBOUND DATE. -------------------------------------------------- WAIVED FOR THE DEATH OF THE PASSENGER OR PASSENGER FAMILY MEMBER OR PASSENGERS TRAVELLING COMPANION. DOCUMENTATION REQUIRED. IN THE EVENT PSGRS ARE CALLED TO JURY DUTY OR ARE SUBPOENAED FULL REFUND WILL APPLY UPON PRESENTATION OF JURY SUMMONS OR SUBPOENA PROVIDED FLIGHT SEGMENTS ARE CANCELLED PRIOR TO TICKETED DEPARTURE DATE. -------------------------------------------------- REPRICE USING ANY FARE TYPE EXCEPT ERU/EOU/ZOU/ZRU/BOU/BRU USED FOR BASIC BRAND. -------------------------------------------------- CHANGE FEE APPLIES PER FARE COMPONENT. -------------------------------------------------- VOLUNTARY CHANGES FOR ANY FLIGHT SEGMENT MUST BE IN ACCORDANCE WITH THE FOLLOWING- A. THE NEW FLIGHT SEGMENT MUST BE REPRICED AND REISSUED WITH CURRENT AND APPLICABLE FARE. B. IF THE NEW FLIGHT SEGMENT IS OF EQUAL OR HIGHER VALUE THE FARE DIFFERENCE MUST BE PAID. C. FLIGHT COUPONS MUST BE USED IN SEQUENCE. CHANGES IN THE SEQUENCE OF ANY FLIGHT COUPON WILL RESULT IN A TICKET REISSUE. -PLEASE NOTE- IF A FARE IS COMBINED WITH HALF A ROUND TRIP FARE IN A CIRCLE TRIP - THE HIGHEST CHANGE FEE AND THE MOST RESTRICTIVE FARE RULE APPLIES TO THE ENTIRE TICKET. -------------------------------------------------- AIRPORT SAME DAY CONFIRMED CHANGE FEE- ON STANDARD -TG TYPE FARES PASSENGERS HOLDING CONFIRMED RESERVATIONS AND TICKETS MAY CONFIRM EARLIER/LATER SAME DAY FLIGHTS BETWEEN THE SAME ORIGIN/DESTINATION/STOPOVER POINTS FOR A NONREFUNDABLE FEE OF CAD100/USD100. FOR ROUTES BETWEEN YOW/YMQ-YTO AND BETWEEN YYC/YEA/YVR ON STANDARD -TG TYPE FARES PASSENGERS HOLDING CONFIRMED RESERVATIONS AND TICKETS MAY STANDBY FOR EARLIER SAME DAY FLIGHTS BETWEEN THE SAME ORIGIN/DESTINATION AT NO CHARGE. NOTE- A. SEAT INVENTORY MUST BE AVAILABLE IN THE CABIN APPLICABLE TO THE FARE CHARGED. B. POLICY APPLIES FOR PASSENGERS NEXT OUTBOUND OR INBOUND ONLY. CHANGES CANNOT BE MADE TO INBOUND SEGMENTS BEFORE THE ORIGINAL TICKETED OUTBOUND HAS BEEN FLOWN. C. CONFIRMED CHANGE MAY ONLY BE MADE AT THE AIRPORT ON THE DAY OF THE FLIGHT AND PRIOR TO THE ORIGINAL DEPARTURE TIME. D. REGULAR FARE RULES APPLY - CHANGE FEES/ADCOL- FOR ANY CHANGES WHICH DO NOT QUALIFY FOR THE AIRPORT SAME DAY CONFIRMED CHANGE FEE. E. SAMEDAY STANDBY NOT ALLOWED EXCEPT FOR STANDARD TYPE FARES BETWEEN YOW/YMQ-YTO AND BETWEEN YYC/YEA/YVR AS NOTED ABOVE. -------------------------------------------------- TICKET UPGRADE - PASSENGERS UPGRADING TO A BUSINESS CLASS FARE /EXCEPT BASIC/ OR PREMIUM ECONOMY FARES/EXCEPT BASIC / WILL NOT BE ASSESSED THE CHANGE FEE. ALL OTHER RULES MUST BE MET. ANY NONREFUNDABLE AMOUNT REMAINS NONREFUNDABLE. -------------------------------------------------- CHANGE FEES ARE SUBJECT TO THE SAME TAXES AS THE ORIGINAL TICKET. "}]}],"bagOptions":[],"extras":{"seats":[{"travelerId":"1","segmentId":"6","seatNumber":"18C"}],"bags":[]},"bookingRequirements":{"emailAddressRequired":true,"mobilePhoneNumberRequired":true,"travelerRequirements":[{"travelerId":"1","genderRequired":true,"dateOfBirthRequired":true,"redressRequiredIfAny":true,"residenceRequired":true}]},"holdAllowed":{"allowed":true,"reason":null}},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"422":{"$ref":"#/components/responses/E422"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/flights/priced-offers/{pricedOfferId}/upsell":{"post":{"operationId":"upsellOffer","tags":["Shopping"],"summary":"Fare families (upsell)","description":"Fare families (upsell): the other fare families (brands) of the same flights, each a new offer with its own `offerId` and selling price. Price the one you want, then book it.","x-scope":"flights:search","x-try-it":true,"x-errors":[{"status":404,"code":"PRICED_OFFER_EXPIRED","when":"The priced offer is unknown or expired. Price the offer again.","example":{"error":{"code":"PRICED_OFFER_EXPIRED","message":"This priced offer is unknown or expired. Price the offer again.","requestId":"85a23454-fe65-4155-9fcf-57bc82c3a066"}}}],"parameters":[{"name":"pricedOfferId","in":"path","required":true,"description":"`pricedOfferId` from Price an offer.","schema":{"type":"string","description":"Priced offer id.","maxLength":64},"example":"0f15b491-1820-49df-8f13-13b584ebf99a"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"The fare families.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlightSearchResult"},"example":{"searchId":"5WtoxjhOlQrS","expiresAt":"2026-11-18T15:20:18.706Z","count":1,"offers":[{"offerId":"of_5WtoxjhOlQrS_1","groupId":"g1","validatingCarrier":"EK","lastTicketingDate":null,"seatsAvailable":null,"price":{"currency":"USD","total":"1265.80","base":"1152.00","taxes":"113.80"},"itineraries":[{"duration":null,"segments":[{"id":"4","carrier":"EK","flightNumber":"1","operatingCarrier":"EK","from":{"airport":"DXB","terminal":"3","at":"2027-01-02T07:45:00"},"to":{"airport":"LHR","terminal":"3","at":"2027-01-02T11:40:00"},"duration":"PT7H55M","aircraft":"388","stops":0}]}],"fares":[{"travelerId":"1","travelerType":"ADULT","total":"1265.80","segments":[{"segmentId":"4","cabin":"ECONOMY","bookingClass":"Y","fareBasis":"YLOWFAE1","brand":"Economy Flex Plus","brandLabel":null,"checkedBags":{"quantity":null,"weight":35,"weightUnit":"KG"},"cabinBags":null}]}]}]},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/flights/priced-offers/{pricedOfferId}/seatmaps":{"get":{"operationId":"pricedOfferSeatmaps","tags":["Shopping"],"summary":"Seat maps of an offer","description":"Seat map of an offer: every seat of every flight with its availability and selling price per traveller. Some airlines show seats only after ticketing (`available: false` with the reason).","x-scope":"flights:search","x-try-it":true,"x-errors":[{"status":404,"code":"PRICED_OFFER_EXPIRED","when":"The priced offer is unknown or expired. Price the offer again.","example":{"error":{"code":"PRICED_OFFER_EXPIRED","message":"This priced offer is unknown or expired. Price the offer again.","requestId":"b3a97b42-0417-4536-b5fc-cf48a1d46bbd"}}}],"parameters":[{"name":"pricedOfferId","in":"path","required":true,"description":"`pricedOfferId` from Price an offer.","schema":{"type":"string","description":"Priced offer id.","maxLength":64},"example":"0f15b491-1820-49df-8f13-13b584ebf99a"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"The seat maps.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeatMaps"},"example":{"available":true,"reason":null,"flights":[{"segmentId":"6","carrier":"AC","flightNumber":"125","from":{"airport":"YYZ","at":"2027-01-17T20:20:00"},"to":{"airport":"YVR","at":"2027-01-17T23:22:00"},"aircraft":"789","bookingClass":"G","availableSeats":[{"travelerId":"1","count":230}],"decks":[{"deckType":"MAIN","facilities":[{"code":"LA","row":"30","column":"D","position":"SEAT"},{"code":"LA","row":"30","column":"G","position":"SEAT"},{"code":"LA","row":"30","column":"H","position":"SEAT"}],"seats":[{"number":"18A","row":18,"column":"A","cabin":"ECONOMY","characteristics":["3","CH","EC","K","O","OW","W","1A_AQC_PREMIUM_SEAT"],"window":true,"aisle":false,"exitRow":false,"travelers":[{"travelerId":"1","status":"OCCUPIED","price":{"currency":"USD","total":"120.50"}}]},{"number":"18B","row":18,"column":"B","cabin":"ECONOMY","characteristics":["3","9","CH","EC","K","O","OW","1A_AQC_PREMIUM_SEAT"],"window":false,"aisle":false,"exitRow":false,"travelers":[{"travelerId":"1","status":"OCCUPIED","price":{"currency":"USD","total":"120.50"}}]},{"number":"18C","row":18,"column":"C","cabin":"ECONOMY","characteristics":["3","A","CH","EC","K","O","OW","1A_AQC_PREMIUM_SEAT"],"window":false,"aisle":true,"exitRow":false,"travelers":[{"travelerId":"1","status":"AVAILABLE","price":{"currency":"USD","total":"120.50"}}]},{"number":"18D","row":18,"column":"D","cabin":"ECONOMY","characteristics":["3","A","CH","EC","K","O","OW","1A_AQC_PREMIUM_SEAT"],"window":false,"aisle":true,"exitRow":false,"travelers":[{"travelerId":"1","status":"OCCUPIED","price":{"currency":"USD","total":"120.50"}}]},{"number":"18E","row":18,"column":"E","cabin":"ECONOMY","characteristics":["3","9","B","CH","EC","K","O","OW","1A_AQC_PREMIUM_SEAT"],"window":false,"aisle":false,"exitRow":false,"travelers":[{"travelerId":"1","status":"AVAILABLE","price":{"currency":"USD","total":"120.50"}}]},{"number":"18G","row":18,"column":"G","cabin":"ECONOMY","characteristics":["3","A","CH","EC","K","O","OW","1A_AQC_PREMIUM_SEAT"],"window":false,"aisle":true,"exitRow":false,"travelers":[{"travelerId":"1","status":"AVAILABLE","price":{"currency":"USD","total":"120.50"}}]}]}]}],"characteristics":{"1":"Restricted seat - General","3":"Individual video screen - Choice of movies","9":"Center seat (not window, not aisle)","A":"Aisle seat","B":"Seat with bassinet facility","C":"Crew seat","E":"Exit row seat","1W":"Window seat without window","H":"Seat with facilities for handicapped/incapacitated passenger","K":"Bulkhead seat","1A_AQC_PREMIUM_SEAT":"Premium seat","O":"Preferential seat","U":"Seat suitable for unaccompanied minors","V":"Seat to be left vacant or offered last","W":"Window seat","X":"No facility seat (indifferent seat)","IE":"Seat not suitable for child","EC":"Electronic connection for lap top or FAX machine","CH":"Chargeable seats","OW":"Overwing seat(s)","7A":"In front of toilet seat","AL":"Seat adjacent to lavatory","1A":"Seat not allowed for infant","1B":"Seat not allowed for medical","1C":"Seat not allowed for unaccompanied minor","PC":"Pet cabin","FC":"Front of cabin class/compartment"},"facilities":{"LA":"Lavatory","G":"Galley","GF":"General facility"}},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/flights/bookings":{"post":{"operationId":"createBooking","tags":["Booking"],"summary":"Book a flight","description":"Book a flight. `ticketing: HOLD` books now and issues later with POST /flights/bookings/{id}/issue; nothing is charged. `ticketing: ISSUE` books and issues in one call. **Your wallet is charged only when the ticket is issued**; if the airline refuses the ticket, nothing is charged and the booking stays held (see `issue`). A hold is cancelled automatically before the airline’s ticketing deadline (`booking.holdReleaseAt`).","x-scope":"flights:book","x-try-it":false,"x-errors":[{"status":404,"code":"PRICED_OFFER_EXPIRED","when":"The priced offer is unknown or expired. Price the offer again.","example":{"error":{"code":"PRICED_OFFER_EXPIRED","message":"This priced offer is unknown or expired. Price the offer again.","requestId":"6c556243-0ce8-4f24-8674-e2c7e70c24a8"}}},{"status":403,"code":"AIRLINE_NOT_ENABLED","when":"This flight is not enabled for your account.","example":{"error":{"code":"AIRLINE_NOT_ENABLED","message":"This flight is not enabled for your account.","requestId":"e1b149a7-65bb-43ad-832b-6e1158eda576"}}},{"status":402,"code":"INSUFFICIENT_BALANCE","when":"With ticketing ISSUE: your wallet cannot cover the ticket; nothing was booked.","example":{"error":{"code":"INSUFFICIENT_BALANCE","message":"Your wallet balance does not cover this ticket. Top up first; nothing was booked.","requestId":"36bbba38-1a58-4232-82fd-27e6dcfc98b0","details":{"amount":"1265.80"}}}},{"status":422,"code":"HOLD_NOT_ALLOWED","when":"The fare cannot be held (instant ticketing required, no ticketing deadline, or too close to it): book with ticketing ISSUE.","example":{"error":{"code":"HOLD_NOT_ALLOWED","message":"The airline gives no ticketing deadline for this fare, so it cannot be held. Book it with ticketing ISSUE.","requestId":"bc258050-59e6-4f50-8fe5-f070a16f57c8"}}},{"status":409,"code":"PRICE_CHANGED","when":"The airline price moved from `expectedTotal`; nothing was booked. `details.newTotal` is the new price.","example":{"error":{"code":"PRICE_CHANGED","message":"The airline changed the price. Nothing was booked.","requestId":"d6f44afc-3537-495c-a4af-b2de8c47cab9","details":{"expectedTotal":1215.8,"newTotal":1265.8,"currency":"USD"}}}},{"status":422,"code":"BOOKING_LIMIT_EXCEEDED","when":"Above your single-booking limit.","example":{"error":{"code":"BOOKING_LIMIT_EXCEEDED","message":"This booking (1265.80) is above your single-booking limit of 1.00.","requestId":"dfcd3532-04e7-4b76-9fb0-adc5febd2d76"}}},{"status":429,"code":"DAILY_BOOKING_LIMIT","when":"Your bookings-per-day limit is reached (resets at midnight UTC).","example":{"error":{"code":"DAILY_BOOKING_LIMIT","message":"Your daily limit of 1 booking(s) is reached. It resets at midnight UTC.","requestId":"8a38e818-6170-4b4b-8e1c-a0924f51851f"}}},{"status":429,"code":"HOLD_LIMIT_REACHED","when":"Too many open holds; issue or cancel one first.","example":{"error":{"code":"HOLD_LIMIT_REACHED","message":"You have 1 open hold(s), your limit is 1. Issue or cancel one first.","requestId":"26e84ac5-e413-433d-a59a-962a7de3c627"}}},{"status":400,"code":"CONTACT_EMAIL_EMPTY","when":"contact.email is empty.","example":{"error":{"code":"CONTACT_EMAIL_EMPTY","message":"Email is required","requestId":"1618530f-c714-45d4-8d55-01de8aab5ecf"}}},{"status":400,"code":"CONTACT_EMAIL_TOO_LONG","when":"contact.email is longer than the mail standard allows.","example":{"error":{"code":"CONTACT_EMAIL_TOO_LONG","message":"This email address is too long","requestId":"f537a8a5-de0b-4754-a86f-898908b8b8e6"}}},{"status":400,"code":"CONTACT_EMAIL_FORMAT","when":"contact.email is not an email address.","example":{"error":{"code":"CONTACT_EMAIL_FORMAT","message":"Enter a valid email address, like name@example.com","requestId":"9b1269ee-ad14-4cd6-88a5-628e5663f13d"}}},{"status":400,"code":"CONTACT_EMAIL_DISPOSABLE","when":"contact.email is a throwaway inbox.","example":{"error":{"code":"CONTACT_EMAIL_DISPOSABLE","message":"Please use a permanent email address — temporary inboxes may not receive your tickets","requestId":"e671647a-7e83-48fb-95e6-b03f540beff9"}}},{"status":400,"code":"CONTACT_EMAIL_NO_MAIL_DOMAIN","when":"contact.email’s domain receives no mail."},{"status":400,"code":"CONTACT_PHONE_EMPTY","when":"contact.phone is empty.","example":{"error":{"code":"CONTACT_PHONE_EMPTY","message":"Mobile number is required","requestId":"76983cb7-4187-4b3a-85da-9b3ca03deb41"}}},{"status":400,"code":"CONTACT_PHONE_FORMAT","when":"contact.phone is not in international format (+ and country code).","example":{"error":{"code":"CONTACT_PHONE_FORMAT","message":"Enter the mobile number with its country code","requestId":"00e805e3-767c-406f-b557-203511a98cd5"}}},{"status":400,"code":"CONTACT_PHONE_INVALID","when":"contact.phone is not a valid number.","example":{"error":{"code":"CONTACT_PHONE_INVALID","message":"This isn't a valid number for the selected country — please check it","requestId":"6bfbb633-4d58-4a14-8e48-10fd96748808"}}},{"status":400,"code":"CONTACT_PHONE_NOT_MOBILE","when":"contact.phone is not a mobile number.","example":{"error":{"code":"CONTACT_PHONE_NOT_MOBILE","message":"Please enter a mobile number — the airline sends flight changes by SMS","requestId":"e82343f4-399f-4f30-986a-2e709c28f20d"}}},{"status":422,"code":"BOOKING_REFUSED","when":"The airline or our checks refused the booking (`message` says why); nothing was booked.","example":{"error":{"code":"BOOKING_REFUSED","message":"Passenger details do not match the priced fare. Please start again from the search page.","requestId":"952a6fc2-ae91-4aa7-ad97-78076b8f18c3"}}}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/RequestId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlightBookingRequest"},"example":{"pricedOfferId":"6d94ac3c-b274-4c9b-9339-6cd053108e5a","ticketing":"HOLD","expectedTotal":229.7,"merchantReference":"ORDER-101","contact":{"name":"Jane Traveller","email":"traveller@example.com","phone":"+14155550123"},"travelers":[{"id":"1","title":"MS","firstName":"MARY","lastName":"TRAVELLER","gender":"FEMALE","dateOfBirth":"1988-04-12","passportNumber":"P1234561","documentExpiryDate":"2032-05-10","nationality":"US","issuanceCountry":"US","documentType":"PASSPORT"}]}}}},"responses":{"201":{"description":"The booking and, for ISSUE, the ticketing result.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"},"Idempotent-Replayed":{"$ref":"#/components/headers/Idempotent-Replayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingResult"},"example":{"booking":{"id":"970b5a09-7fa0-45d1-a884-cdcaf770fe0b","reference":"817416111988","merchantReference":"ORDER-101","status":"CONFIRMED","pnr":"B7R7D8","airlineReference":null,"ticketStatus":"NOT_TICKETED","tickets":[],"price":{"currency":"USD","total":"229.70","charged":"0.00"},"holdReleaseAt":"2026-11-19T00:00:00.000Z","itineraries":[{"duration":null,"segments":[{"id":"6","carrier":"AC","flightNumber":"125","operatingCarrier":"AC","from":{"airport":"YYZ","terminal":"1","at":"2027-01-17T20:20:00"},"to":{"airport":"YVR","terminal":"M","at":"2027-01-17T23:22:00"},"duration":"PT5H2M","aircraft":"789","stops":0}]}],"createdAt":"2026-11-18T15:01:18.271Z","updatedAt":"2026-11-18T15:01:23.005Z"},"issue":null},"x-more-examples":[{"label":"ticketing ISSUE: booked, issued and charged in one call","value":{"booking":{"id":"fd9ba604-e1c6-4323-afc1-0e67b2bf4ee8","reference":"546670629340","merchantReference":"ORDER-1002","status":"TICKETED","pnr":"H58L4J","airlineReference":null,"ticketStatus":"TICKETED","tickets":[{"number":"1765767739672","status":"ISSUED","travelerId":null}],"price":{"currency":"USD","total":"1265.80","charged":"1265.80"},"holdReleaseAt":null,"itineraries":[{"duration":null,"segments":[{"id":"4","carrier":"EK","flightNumber":"1","operatingCarrier":"EK","from":{"airport":"DXB","terminal":"3","at":"2027-01-02T07:45:00"},"to":{"airport":"LHR","terminal":"3","at":"2027-01-02T11:40:00"},"duration":"PT7H55M","aircraft":"388","stops":0}]}],"createdAt":"2026-11-18T15:00:19.311Z","updatedAt":"2026-11-18T15:00:41.252Z"},"issue":{"status":"ISSUED","code":null,"message":null,"charged":{"amount":"1265.80","currency":"USD"}}}}]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"409":{"$ref":"#/components/responses/E409"},"422":{"$ref":"#/components/responses/E422"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/flights/bookings/{id}/issue":{"post":{"operationId":"issueBooking","tags":["Booking"],"summary":"Issue the ticket","description":"Issue the ticket. Before issuing, the booking is read again from the airline: if the airline’s price changed, nothing is charged (PRICE_CHANGED). The amount is held on your wallet, the ticket is issued, and the hold is **charged only when the airline issues the ticket**. Refused by the airline → nothing charged, the booking stays held. `issue.status: PENDING` = the airline has not confirmed yet: charged, retried automatically.","x-scope":"flights:book","x-try-it":false,"x-errors":[{"status":404,"code":"BOOKING_NOT_FOUND","when":"No such booking on your account.","example":{"error":{"code":"BOOKING_NOT_FOUND","message":"No such booking on your account.","requestId":"4f5940b5-2bb9-4d3c-8594-ea6c81c91c8b"}}},{"status":409,"code":"NOT_BOOKED","when":"The booking has no airline record.","example":{"error":{"code":"NOT_BOOKED","message":"This booking has no airline record yet.","requestId":"e3e834c8-0d29-4072-a848-b2caf273addd"}}},{"status":422,"code":"NOT_ISSUABLE","when":"Already ticketed, cancelled, or no longer issuable.","example":{"error":{"code":"NOT_ISSUABLE","message":"This booking is already ticketed.","requestId":"84498e42-ba61-44a6-9d8d-fab080239f98"}}},{"status":422,"code":"HOLD_EXPIRED","when":"The hold passed its release time and is being cancelled."},{"status":409,"code":"ISSUE_IN_PROGRESS","when":"Another issue call for this booking is running.","example":{"error":{"code":"ISSUE_IN_PROGRESS","message":"This booking is already being issued. Read it again in a moment.","requestId":"af66cb1d-5db2-47d0-8fea-35d8f4509a98"}}},{"status":409,"code":"PRICE_CHANGED","when":"The airline’s price for the booking changed since it was made; nothing was charged. `details` shows both totals."},{"status":402,"code":"INSUFFICIENT_BALANCE","when":"Your wallet cannot cover the ticket; nothing was charged.","example":{"error":{"code":"INSUFFICIENT_BALANCE","message":"Your wallet balance does not cover this ticket. Top up and issue again; nothing was charged.","requestId":"335959b3-c3ba-455a-b301-19da89b19add","details":{"amount":"229.70","currency":"USD"}}}},{"status":422,"code":"BOOKING_LIMIT_EXCEEDED","when":"The amount (with seats added) is above your single-booking limit.","example":{"error":{"code":"BOOKING_LIMIT_EXCEEDED","message":"This booking (229.70) is above your single-booking limit of 1.00.","requestId":"448a4fe8-c626-4aa6-b297-c5747b3f8713"}}},{"status":422,"code":"TICKETING_REFUSED","when":"The airline refused the ticket; nothing was charged and the booking is still held."},{"status":502,"code":"AIRLINE_UNAVAILABLE","when":"The airline system did not answer; nothing was charged."}],"parameters":[{"name":"id","in":"path","required":true,"description":"The booking `id` (UUID), its `reference` (12 digits) or its `pnr` (6 letters and digits).","schema":{"type":"string","description":"Booking id, reference or PNR.","maxLength":64},"example":"771e85e6-3ff4-43b4-ae51-5cc81a39a401"},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"The booking and the ticketing result.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"},"Idempotent-Replayed":{"$ref":"#/components/headers/Idempotent-Replayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingResult"},"example":{"booking":{"id":"771e85e6-3ff4-43b4-ae51-5cc81a39a401","reference":"225926051232","merchantReference":"ORDER-103","status":"TICKETED","pnr":"B7QU3G","airlineReference":null,"ticketStatus":"TICKETED","tickets":[{"number":"014-7594003910","status":"ISSUED","travelerId":"1"}],"price":{"currency":"USD","total":"229.70","charged":"229.70"},"holdReleaseAt":null,"itineraries":[{"duration":null,"segments":[{"id":"6","carrier":"AC","flightNumber":"125","operatingCarrier":"AC","from":{"airport":"YYZ","terminal":"1","at":"2027-01-17T20:20:00"},"to":{"airport":"YVR","terminal":"M","at":"2027-01-17T23:22:00"},"duration":"PT5H2M","aircraft":"789","stops":0}]}],"createdAt":"2026-11-18T15:01:51.830Z","updatedAt":"2026-11-18T15:02:00.939Z"},"issue":{"status":"ISSUED","code":null,"message":null,"charged":{"amount":"229.70","currency":"USD"}}},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"409":{"$ref":"#/components/responses/E409"},"422":{"$ref":"#/components/responses/E422"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"}}}},"/flights/bookings/by-reference/{pnr}":{"get":{"operationId":"getBookingByReference","tags":["Booking"],"summary":"Get a booking by PNR","description":"Find a booking by PNR: your booking with this PNR (never another merchant’s), read live from the airline. Same answer and options as Get a booking.","x-scope":"bookings:read","x-try-it":true,"x-errors":[{"status":404,"code":"BOOKING_NOT_FOUND","when":"No booking of yours has this PNR.","example":{"error":{"code":"BOOKING_NOT_FOUND","message":"No such booking on your account.","requestId":"96d6fa6f-2c13-466e-91d9-d806b3852208"}}},{"status":502,"code":"AIRLINE_RECORD_UNAVAILABLE","when":"The airline system did not answer. Try again."}],"parameters":[{"name":"pnr","in":"path","required":true,"description":"The record locator (6 letters and digits).","schema":{"type":"string","description":"PNR.","pattern":"^[A-Za-z0-9]{6}$"},"example":"H58L4J"},{"name":"include","in":"query","required":false,"description":"`bags` adds the extra bags the airline sells for this booking (`bagOptions`).","schema":{"type":"string","description":"What to add.","enum":["bags"]}},{"name":"fareRules","in":"query","required":false,"description":"Adds the airline’s rules for this booking (`airlineFareRules`): `refunds`, `rebooks`, or both comma-separated.","schema":{"type":"string","description":"Comma-separated: refunds, rebooks.","pattern":"^(refunds|rebooks)(,(refunds|rebooks))?$"},"example":"refunds"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"The booking.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingRead"},"example":{"booking":{"id":"fd9ba604-e1c6-4323-afc1-0e67b2bf4ee8","reference":"546670629340","merchantReference":"ORDER-1002","status":"VOIDED","pnr":"H58L4J","airlineReference":null,"ticketStatus":"VOIDED","tickets":[{"number":"1765767739672","status":"VOIDED","travelerId":null}],"price":{"currency":"USD","total":"1265.80","charged":"1265.80"},"holdReleaseAt":null,"itineraries":[{"duration":null,"segments":[{"id":"4","carrier":"EK","flightNumber":"1","operatingCarrier":"EK","from":{"airport":"DXB","terminal":"3","at":"2027-01-02T07:45:00"},"to":{"airport":"LHR","terminal":"3","at":"2027-01-02T11:40:00"},"duration":"PT7H55M","aircraft":"388","stops":0}]}],"createdAt":"2026-11-18T15:00:19.311Z","updatedAt":"2026-11-18T15:01:01.123Z"},"airlineRecord":{"found":false,"retrievedAt":"2026-11-18T15:01:04.650Z","records":[],"travelers":[],"itineraries":[],"tickets":[]},"airlineFareRules":[]},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"}}}},"/flights/bookings/{id}":{"get":{"operationId":"getBooking","tags":["Booking"],"summary":"Get a booking","description":"Get a booking: our record of the booking (price, what was charged, tickets) and the airline record read LIVE (segment status, ticket status, travellers). `airlineRecord.found` is false once the airline no longer holds it (after a void or cancellation).","x-scope":"bookings:read","x-try-it":true,"x-errors":[{"status":404,"code":"BOOKING_NOT_FOUND","when":"No such booking on your account.","example":{"error":{"code":"BOOKING_NOT_FOUND","message":"No such booking on your account.","requestId":"58a66a1d-87d0-468a-98ab-31b672a1a5fd"}}},{"status":502,"code":"AIRLINE_RECORD_UNAVAILABLE","when":"The airline system did not answer. Try again."}],"parameters":[{"name":"id","in":"path","required":true,"description":"The booking `id` (UUID), its `reference` (12 digits) or its `pnr` (6 letters and digits).","schema":{"type":"string","description":"Booking id, reference or PNR.","maxLength":64},"example":"771e85e6-3ff4-43b4-ae51-5cc81a39a401"},{"name":"include","in":"query","required":false,"description":"`bags` adds the extra bags the airline sells for this booking (`bagOptions`).","schema":{"type":"string","description":"What to add.","enum":["bags"]},"example":"bags"},{"name":"fareRules","in":"query","required":false,"description":"Adds the airline’s rules for this booking (`airlineFareRules`): `refunds`, `rebooks`, or both comma-separated.","schema":{"type":"string","description":"Comma-separated: refunds, rebooks.","pattern":"^(refunds|rebooks)(,(refunds|rebooks))?$"},"example":"refunds,rebooks"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"The booking.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingRead"},"example":{"booking":{"id":"771e85e6-3ff4-43b4-ae51-5cc81a39a401","reference":"225926051232","merchantReference":"ORDER-103","status":"TICKETED","pnr":"B7QU3G","airlineReference":null,"ticketStatus":"TICKETED","tickets":[{"number":"014-7594003910","status":"ISSUED","travelerId":"1"}],"price":{"currency":"USD","total":"229.70","charged":"229.70"},"holdReleaseAt":null,"itineraries":[{"duration":null,"segments":[{"id":"6","carrier":"AC","flightNumber":"125","operatingCarrier":"AC","from":{"airport":"YYZ","terminal":"1","at":"2027-01-17T20:20:00"},"to":{"airport":"YVR","terminal":"M","at":"2027-01-17T23:22:00"},"duration":"PT5H2M","aircraft":"789","stops":0}]}],"createdAt":"2026-11-18T15:01:51.830Z","updatedAt":"2026-11-18T15:02:00.939Z"},"airlineRecord":{"found":true,"retrievedAt":"2026-11-18T15:02:08.573Z","records":[{"reference":"B7QU3G","airline":"AC","createdAt":null},{"reference":"B7QU3G","airline":null,"createdAt":"2026-11-18T15:02:00"}],"travelers":[{"id":"1","firstName":"LUCY","lastName":"TRAVELLER","dateOfBirth":"1988-04-12","gender":"FEMALE"}],"itineraries":[{"duration":null,"segments":[{"id":"1","carrier":"AC","flightNumber":"125","operatingCarrier":null,"from":{"airport":"YYZ","terminal":"1","at":"2027-01-17T20:20:00"},"to":{"airport":"YVR","terminal":"M","at":"2027-01-17T23:22:00"},"duration":"PT5H2M","aircraft":"789","stops":0,"status":"CONFIRMED","type":"ACTIVE","flown":false}]}],"tickets":[{"number":"014-7594003910","type":"ETICKET","status":"ISSUED","travelerId":"1","segmentIds":["1"],"issuedAt":"2026-11-18T15:02:00z"}]},"bagOptions":[],"airlineFareRules":[{"category":"REFUND","notApplicable":false,"maxPenaltyAmount":null,"currency":null},{"category":"REBOOK","notApplicable":false,"maxPenaltyAmount":null,"currency":null},{"category":"REBOOK","notApplicable":false,"maxPenaltyAmount":null,"currency":null}]},"x-more-examples":[{"label":"After a void: the airline no longer holds the record","value":{"booking":{"id":"771e85e6-3ff4-43b4-ae51-5cc81a39a401","reference":"225926051232","merchantReference":"ORDER-103","status":"VOIDED","pnr":"B7QU3G","airlineReference":null,"ticketStatus":"VOIDED","tickets":[{"number":"014-7594003910","status":"VOIDED","travelerId":"1"}],"price":{"currency":"USD","total":"229.70","charged":"229.70"},"holdReleaseAt":null,"itineraries":[{"duration":null,"segments":[{"id":"6","carrier":"AC","flightNumber":"125","operatingCarrier":"AC","from":{"airport":"YYZ","terminal":"1","at":"2027-01-17T20:20:00"},"to":{"airport":"YVR","terminal":"M","at":"2027-01-17T23:22:00"},"duration":"PT5H2M","aircraft":"789","stops":0}]}],"createdAt":"2026-11-18T15:01:51.830Z","updatedAt":"2026-11-18T15:02:55.990Z"},"airlineRecord":{"found":false,"retrievedAt":"2026-11-18T15:02:57.317Z","records":[],"travelers":[],"itineraries":[],"tickets":[]}}}]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"}}},"patch":{"operationId":"updateBooking","tags":["Booking"],"summary":"Add seats or documents","description":"Update a booking — two updates: add paid seats (before the ticket is issued; the seat’s selling price is added to the amount charged at issue) and add travel documents to travellers. Free seats are chosen at check-in.","x-scope":"flights:manage","x-try-it":false,"x-errors":[{"status":404,"code":"BOOKING_NOT_FOUND","when":"No such booking on your account.","example":{"error":{"code":"BOOKING_NOT_FOUND","message":"No such booking on your account.","requestId":"d14a9562-2758-40ce-9608-4c343623cf40"}}},{"status":409,"code":"NOT_BOOKED","when":"The booking has no airline record.","example":{"error":{"code":"NOT_BOOKED","message":"This booking has no airline record yet.","requestId":"f3eda8a6-75cb-45c9-83a3-472dcfa7abdf"}}},{"status":400,"code":"UNKNOWN_TRAVELER","when":"A traveller id is not on the booking.","example":{"error":{"code":"UNKNOWN_TRAVELER","message":"Traveller \"9\" is not on this booking.","requestId":"7870c55c-aed1-4ddf-a8a2-d316a47d6529"}}},{"status":422,"code":"SEATS_REFUSED","when":"The seat cannot be added (free seat, taken, already seated, or the booking is issued).","example":{"error":{"code":"SEATS_REFUSED","message":"Seats can no longer be added through us once the ticket is issued — choose them with the airline.","requestId":"0ea1f13b-be27-4173-a4e3-944a487dd9c9"}}},{"status":503,"code":"SEAT_OUTCOME_UNKNOWN","when":"The airline did not answer; we are checking whether the seat was added. Nothing is charged until it is confirmed."},{"status":422,"code":"DOCUMENTS_REFUSED","when":"The airline did not accept the documents."},{"status":502,"code":"AIRLINE_RECORD_UNAVAILABLE","when":"The airline system did not answer. Read the booking to see what changed."}],"parameters":[{"name":"id","in":"path","required":true,"description":"The booking `id` (UUID), its `reference` (12 digits) or its `pnr` (6 letters and digits).","schema":{"type":"string","description":"Booking id, reference or PNR.","maxLength":64},"example":"970b5a09-7fa0-45d1-a884-cdcaf770fe0b"},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/RequestId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingUpdateRequest"},"example":{"seats":[{"travelerId":"1","segmentId":"1","seatNumber":"18C"}]}}}},"responses":{"200":{"description":"The booking after the change.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"},"Idempotent-Replayed":{"$ref":"#/components/headers/Idempotent-Replayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingRead"},"example":{"booking":{"id":"970b5a09-7fa0-45d1-a884-cdcaf770fe0b","reference":"817416111988","merchantReference":"ORDER-101","status":"CONFIRMED","pnr":"B7R7D8","airlineReference":null,"ticketStatus":"NOT_TICKETED","tickets":[],"price":{"currency":"USD","total":"350.20","charged":"0.00"},"holdReleaseAt":"2026-11-19T00:00:00.000Z","itineraries":[{"duration":null,"segments":[{"id":"6","carrier":"AC","flightNumber":"125","operatingCarrier":"AC","from":{"airport":"YYZ","terminal":"1","at":"2027-01-17T20:20:00"},"to":{"airport":"YVR","terminal":"M","at":"2027-01-17T23:22:00"},"duration":"PT5H2M","aircraft":"789","stops":0}]}],"createdAt":"2026-11-18T15:01:18.271Z","updatedAt":"2026-11-18T15:01:23.005Z"},"airlineRecord":{"found":true,"retrievedAt":"2026-11-18T15:01:46.500Z","records":[{"reference":"B7R7D8","airline":"AC","createdAt":null},{"reference":"B7R7D8","airline":null,"createdAt":"2026-11-18T15:01:00"}],"travelers":[{"id":"1","firstName":"MARY","lastName":"TRAVELLER","dateOfBirth":"1988-04-12","gender":"FEMALE"}],"itineraries":[{"duration":null,"segments":[{"id":"1","carrier":"AC","flightNumber":"125","operatingCarrier":null,"from":{"airport":"YYZ","terminal":"1","at":"2027-01-17T20:20:00"},"to":{"airport":"YVR","terminal":"M","at":"2027-01-17T23:22:00"},"duration":"PT5H2M","aircraft":"789","stops":0,"status":"CONFIRMED","type":"ACTIVE","flown":false}]}],"tickets":[]}},"x-more-examples":[{"label":"Travel documents added","value":{"booking":{"id":"970b5a09-7fa0-45d1-a884-cdcaf770fe0b","reference":"817416111988","merchantReference":"ORDER-101","status":"CONFIRMED","pnr":"B7R7D8","airlineReference":null,"ticketStatus":"NOT_TICKETED","tickets":[],"price":{"currency":"USD","total":"229.70","charged":"0.00"},"holdReleaseAt":"2026-11-19T00:00:00.000Z","itineraries":[{"duration":null,"segments":[{"id":"6","carrier":"AC","flightNumber":"125","operatingCarrier":"AC","from":{"airport":"YYZ","terminal":"1","at":"2027-01-17T20:20:00"},"to":{"airport":"YVR","terminal":"M","at":"2027-01-17T23:22:00"},"duration":"PT5H2M","aircraft":"789","stops":0}]}],"createdAt":"2026-11-18T15:01:18.271Z","updatedAt":"2026-11-18T15:01:23.005Z"},"airlineRecord":{"found":true,"retrievedAt":"2026-11-18T15:01:31.566Z","records":[{"reference":"B7R7D8","airline":"AC","createdAt":null},{"reference":"B7R7D8","airline":null,"createdAt":"2026-11-18T15:01:00"}],"travelers":[{"id":"1","firstName":"MARY","lastName":"TRAVELLER","dateOfBirth":"1988-04-12","gender":"FEMALE"}],"itineraries":[{"duration":null,"segments":[{"id":"1","carrier":"AC","flightNumber":"125","operatingCarrier":null,"from":{"airport":"YYZ","terminal":"1","at":"2027-01-17T20:20:00"},"to":{"airport":"YVR","terminal":"M","at":"2027-01-17T23:22:00"},"duration":"PT5H2M","aircraft":"789","stops":0,"status":"CONFIRMED","type":"ACTIVE","flown":false}]}],"tickets":[]}}}]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"409":{"$ref":"#/components/responses/E409"},"422":{"$ref":"#/components/responses/E422"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}},"delete":{"operationId":"cancelBooking","tags":["Booking"],"summary":"Cancel a booking","description":"Cancel a booking. Not issued → cancelled, nothing was charged. Issued and still inside the airline’s void window → voided, the whole amount back to your wallet. Issued after the window → cancelled; the refund (fare minus the airline penalty) reaches your wallet once the airline has processed it. `cancellation` says which.","x-scope":"flights:manage","x-try-it":false,"x-errors":[{"status":404,"code":"BOOKING_NOT_FOUND","when":"No such booking on your account.","example":{"error":{"code":"BOOKING_NOT_FOUND","message":"No such booking on your account.","requestId":"fbf84125-bc23-4542-98ec-d309f1c7a607"}}},{"status":409,"code":"NOT_BOOKED","when":"The booking has no airline record.","example":{"error":{"code":"NOT_BOOKED","message":"This booking has no airline record yet.","requestId":"2fa44c7d-ab59-4fb0-a8db-6905e4b8c389"}}},{"status":409,"code":"TICKET_BEING_ISSUED","when":"The booking is charged and its ticket is still being issued (the airline has not confirmed it yet). Read it again in a few minutes; once ticketed it can be voided."},{"status":409,"code":"AIRLINE_BUSY","when":"The airline is still processing a change (often right after issuing). Nothing changed; retry after `details.retryAfterSeconds`.","example":{"error":{"code":"AIRLINE_BUSY","message":"The airline is still processing a change to this booking. Nothing was changed; retry in about 30 seconds.","requestId":"6ed1173b-2103-4ad9-a061-d8c48ddd8fd8","details":{"retryAfterSeconds":30}}}},{"status":422,"code":"CANCEL_REFUSED","when":"The airline refused the cancellation or void; nothing changed and no money moved.","example":{"error":{"code":"CANCEL_REFUSED","message":"The airline did not accept the cancellation. Nothing changed and no money moved. Try again later, or contact Flyzafy support with the booking reference.","requestId":"4f717d39-dd16-4d37-b978-808f88c9806c"}}}],"parameters":[{"name":"id","in":"path","required":true,"description":"The booking `id` (UUID), its `reference` (12 digits) or its `pnr` (6 letters and digits).","schema":{"type":"string","description":"Booking id, reference or PNR.","maxLength":64},"example":"771e85e6-3ff4-43b4-ae51-5cc81a39a401"},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"The booking and what happened to the money.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"},"Idempotent-Replayed":{"$ref":"#/components/headers/Idempotent-Replayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancellationResult"},"example":{"booking":{"id":"771e85e6-3ff4-43b4-ae51-5cc81a39a401","reference":"225926051232","merchantReference":"ORDER-103","status":"VOIDED","pnr":"B7QU3G","airlineReference":null,"ticketStatus":"VOIDED","tickets":[{"number":"014-7594003910","status":"VOIDED","travelerId":"1"}],"price":{"currency":"USD","total":"229.70","charged":"229.70"},"holdReleaseAt":null,"itineraries":[{"duration":null,"segments":[{"id":"6","carrier":"AC","flightNumber":"125","operatingCarrier":"AC","from":{"airport":"YYZ","terminal":"1","at":"2027-01-17T20:20:00"},"to":{"airport":"YVR","terminal":"M","at":"2027-01-17T23:22:00"},"duration":"PT5H2M","aircraft":"789","stops":0}]}],"createdAt":"2026-11-18T15:01:51.830Z","updatedAt":"2026-11-18T15:02:55.990Z"},"cancellation":{"type":"VOID","refund":"FULL","message":"Voided: the whole amount went back to your wallet."}},"x-more-examples":[{"label":"Un-issued hold cancelled: nothing was charged","value":{"booking":{"id":"970b5a09-7fa0-45d1-a884-cdcaf770fe0b","reference":"817416111988","merchantReference":"ORDER-101","status":"CANCELLED","pnr":"B7R7D8","airlineReference":null,"ticketStatus":"NOT_TICKETED","tickets":[],"price":{"currency":"USD","total":"350.20","charged":"0.00"},"holdReleaseAt":null,"itineraries":[{"duration":null,"segments":[{"id":"6","carrier":"AC","flightNumber":"125","operatingCarrier":"AC","from":{"airport":"YYZ","terminal":"1","at":"2027-01-17T20:20:00"},"to":{"airport":"YVR","terminal":"M","at":"2027-01-17T23:22:00"},"duration":"PT5H2M","aircraft":"789","stops":0}]}],"createdAt":"2026-11-18T15:01:18.271Z","updatedAt":"2026-11-18T15:01:50.358Z"},"cancellation":{"type":"CANCEL","refund":"NONE","message":"Cancelled before issue: nothing was charged."}}}]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"409":{"$ref":"#/components/responses/E409"},"422":{"$ref":"#/components/responses/E422"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/flights/bookings/{id}/seatmaps":{"get":{"operationId":"bookingSeatmaps","tags":["Booking"],"summary":"Seat maps of a booking","description":"Seat map of a booking: the seats of the booked flights. While the booking is held and unpaid, paid seats show their selling price and `canAddSeats` is true — add one with PATCH /flights/bookings/{id}.","x-scope":"bookings:read","x-try-it":true,"x-errors":[{"status":404,"code":"BOOKING_NOT_FOUND","when":"No such booking on your account.","example":{"error":{"code":"BOOKING_NOT_FOUND","message":"No such booking on your account.","requestId":"8534e057-a59b-48cf-b123-58fde267eeeb"}}},{"status":409,"code":"NOT_BOOKED","when":"The booking has no airline record.","example":{"error":{"code":"NOT_BOOKED","message":"This booking has no airline record yet.","requestId":"479b5b49-9e82-42b0-8dde-50970722c28b"}}}],"parameters":[{"name":"id","in":"path","required":true,"description":"The booking `id` (UUID), its `reference` (12 digits) or its `pnr` (6 letters and digits).","schema":{"type":"string","description":"Booking id, reference or PNR.","maxLength":64},"example":"74bae141-5643-44a0-bafe-f0f7bf4ee291"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"The seat maps.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingSeatMaps"},"example":{"available":true,"reason":null,"canAddSeats":true,"addSeatsNote":null,"flights":[{"segmentId":"1","carrier":"AC","flightNumber":"125","from":{"airport":"YYZ","at":"2027-01-17T20:20:00"},"to":{"airport":"YVR","at":"2027-01-17T23:22:00"},"aircraft":"789","bookingClass":"G","availableSeats":[{"travelerId":"1","count":230}],"decks":[{"deckType":"MAIN","facilities":[{"code":"LA","row":"30","column":"D","position":"SEAT"},{"code":"LA","row":"30","column":"G","position":"SEAT"},{"code":"LA","row":"30","column":"H","position":"SEAT"}],"seats":[{"number":"18A","row":18,"column":"A","cabin":"ECONOMY","characteristics":["3","CH","EC","K","O","OW","W","1A_AQC_PREMIUM_SEAT"],"window":true,"aisle":false,"exitRow":false,"travelers":[{"travelerId":"1","status":"OCCUPIED","price":{"currency":"USD","total":"120.50"}}]},{"number":"18B","row":18,"column":"B","cabin":"ECONOMY","characteristics":["3","9","CH","EC","K","O","OW","1A_AQC_PREMIUM_SEAT"],"window":false,"aisle":false,"exitRow":false,"travelers":[{"travelerId":"1","status":"OCCUPIED","price":{"currency":"USD","total":"120.50"}}]},{"number":"18C","row":18,"column":"C","cabin":"ECONOMY","characteristics":["3","A","CH","EC","K","O","OW","1A_AQC_PREMIUM_SEAT"],"window":false,"aisle":true,"exitRow":false,"travelers":[{"travelerId":"1","status":"AVAILABLE","price":{"currency":"USD","total":"120.50"}}]},{"number":"18D","row":18,"column":"D","cabin":"ECONOMY","characteristics":["3","A","CH","EC","K","O","OW","1A_AQC_PREMIUM_SEAT"],"window":false,"aisle":true,"exitRow":false,"travelers":[{"travelerId":"1","status":"OCCUPIED","price":{"currency":"USD","total":"120.50"}}]},{"number":"18E","row":18,"column":"E","cabin":"ECONOMY","characteristics":["3","9","B","CH","EC","K","O","OW","1A_AQC_PREMIUM_SEAT"],"window":false,"aisle":false,"exitRow":false,"travelers":[{"travelerId":"1","status":"AVAILABLE","price":{"currency":"USD","total":"120.50"}}]},{"number":"18G","row":18,"column":"G","cabin":"ECONOMY","characteristics":["3","A","CH","EC","K","O","OW","1A_AQC_PREMIUM_SEAT"],"window":false,"aisle":true,"exitRow":false,"travelers":[{"travelerId":"1","status":"AVAILABLE","price":{"currency":"USD","total":"120.50"}}]}]}]}],"characteristics":{"1":"Restricted seat - General","3":"Individual video screen - Choice of movies","9":"Center seat (not window, not aisle)","A":"Aisle seat","B":"Seat with bassinet facility","C":"Crew seat","E":"Exit row seat","1W":"Window seat without window","H":"Seat with facilities for handicapped/incapacitated passenger","K":"Bulkhead seat","1A_AQC_PREMIUM_SEAT":"Premium seat","O":"Preferential seat","U":"Seat suitable for unaccompanied minors","V":"Seat to be left vacant or offered last","W":"Window seat","X":"No facility seat (indifferent seat)","IE":"Seat not suitable for child","EC":"Electronic connection for lap top or FAX machine","CH":"Chargeable seats","OW":"Overwing seat(s)","7A":"In front of toilet seat","AL":"Seat adjacent to lavatory","1A":"Seat not allowed for infant","1B":"Seat not allowed for medical","1C":"Seat not allowed for unaccompanied minor","PC":"Pet cabin","FC":"Front of cabin class/compartment"},"facilities":{"LA":"Lavatory","G":"Galley","GF":"General facility"}},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"409":{"$ref":"#/components/responses/E409"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/webhooks":{"get":{"operationId":"listWebhooks","tags":["Webhooks"],"summary":"List endpoints","description":"The endpoints that receive your events (never their secrets), and every event you can subscribe to.","x-scope":"webhooks:manage","x-try-it":true,"x-errors":[],"parameters":[{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Endpoints and events.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"object","description":"Webhook endpoints.","properties":{"endpoints":{"type":"array","description":"Your endpoints (at most 5).","items":{"$ref":"#/components/schemas/WebhookEndpoint"}},"availableEvents":{"type":"array","description":"Every event name you can subscribe to.","items":{"type":"string","description":"Event name.","enum":["booking.created","booking.ticketed","booking.ticketing_failed","booking.ticketing_partial","booking.failed","booking.attach_failed","booking.queue_alert","booking.exchange_requested","booking.cancelled","booking.cancellation_requested","booking.voided","booking.refunded","wallet.debited","wallet.credited","wallet.reconciliation_drift","car.booking.confirmed","car.booking.cancelled","transfer.booking.confirmed","transfer.booking.cancelled"]}}},"required":["endpoints","availableEvents"]},"example":{"endpoints":[{"id":"417b8b86-387e-4af8-a0e4-50af52e3ff81","url":"https://example.com/flyzafy-webhooks","status":"ACTIVE","events":["booking.created","booking.ticketed","car.booking.confirmed"],"secretLast4":"00ac","createdAt":"2026-11-15T16:31:34.459Z","updatedAt":"2026-11-15T16:31:34.458Z"}],"availableEvents":["booking.created","booking.ticketed","booking.ticketing_failed"]},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}},"post":{"operationId":"createWebhook","tags":["Webhooks"],"summary":"Add an endpoint","description":"The response carries the signing `secret` — the only time it is shown. Store it to check `Webhook-Signature`.","x-scope":"webhooks:manage","x-try-it":false,"x-errors":[{"status":400,"code":"INVALID_REQUEST","when":"The URL is not public https://, an event name is unknown, or you already have 5 endpoints.","example":{"error":{"code":"INVALID_REQUEST","message":"The address must start with https://","requestId":"2a3cd391-0791-4d40-b9a7-ca7f9ce42752"}}}],"parameters":[{"$ref":"#/components/parameters/RequestId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"A new endpoint.","properties":{"url":{"type":"string","description":"Public `https://` address that receives the events. Private and local addresses are refused; redirects are not followed.","maxLength":500,"format":"uri"},"events":{"type":"array","description":"Event names to receive, or `[\"*\"]` for all. Default: all.","items":{"type":"string","description":"Event name or `*`.","enum":["booking.created","booking.ticketed","booking.ticketing_failed","booking.ticketing_partial","booking.failed","booking.attach_failed","booking.queue_alert","booking.exchange_requested","booking.cancelled","booking.cancellation_requested","booking.voided","booking.refunded","wallet.debited","wallet.credited","wallet.reconciliation_drift","car.booking.confirmed","car.booking.cancelled","transfer.booking.confirmed","transfer.booking.cancelled","*"]},"maxItems":50}},"required":["url"]},"example":{"url":"https://example.com/flyzafy-webhooks","events":["booking.created","booking.ticketed","car.booking.confirmed"]}}}},"responses":{"201":{"description":"The endpoint with its secret.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointWithSecret"},"example":{"id":"417b8b86-387e-4af8-a0e4-50af52e3ff81","url":"https://example.com/flyzafy-webhooks","status":"ACTIVE","events":["booking.created","booking.ticketed","car.booking.confirmed"],"secretLast4":"00ac","createdAt":"2026-11-15T16:31:34.459Z","updatedAt":"2026-11-15T16:31:34.458Z","secret":"<redacted>"},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/webhooks/{id}":{"patch":{"operationId":"updateWebhook","tags":["Webhooks"],"summary":"Update an endpoint","description":"Send only what changes.","x-scope":"webhooks:manage","x-try-it":false,"x-errors":[{"status":404,"code":"NOT_FOUND","when":"No such endpoint on your account.","example":{"error":{"code":"NOT_FOUND","message":"Webhook endpoint not found","requestId":"b17e0e59-62e6-4953-98c3-e29119391c7b"}}}],"parameters":[{"name":"id","in":"path","required":true,"description":"Endpoint id.","schema":{"type":"string","description":"Endpoint id (UUID)."},"example":"417b8b86-387e-4af8-a0e4-50af52e3ff81"},{"$ref":"#/components/parameters/RequestId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"The changes.","properties":{"url":{"type":"string","description":"New public `https://` address.","maxLength":500,"format":"uri"},"events":{"type":"array","description":"New list of events (replaces the old one).","items":{"type":"string","description":"Event name or `*`.","enum":["booking.created","booking.ticketed","booking.ticketing_failed","booking.ticketing_partial","booking.failed","booking.attach_failed","booking.queue_alert","booking.exchange_requested","booking.cancelled","booking.cancellation_requested","booking.voided","booking.refunded","wallet.debited","wallet.credited","wallet.reconciliation_drift","car.booking.confirmed","car.booking.cancelled","transfer.booking.confirmed","transfer.booking.cancelled","*"]},"maxItems":50},"status":{"type":"string","description":"DISABLED stops deliveries; ACTIVE resumes them.","enum":["ACTIVE","DISABLED"]}}},"example":{"events":["booking.ticketed","booking.cancelled","booking.voided"]}}}},"responses":{"200":{"description":"The endpoint.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"},"example":{"id":"417b8b86-387e-4af8-a0e4-50af52e3ff81","url":"https://example.com/flyzafy-webhooks","status":"ACTIVE","events":["booking.ticketed","booking.cancelled","booking.voided"],"secretLast4":"00ac","createdAt":"2026-11-15T16:31:34.459Z","updatedAt":"2026-11-15T16:31:34.486Z"},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}},"delete":{"operationId":"deleteWebhook","tags":["Webhooks"],"summary":"Delete an endpoint","description":"Stops deliveries to it at once.","x-scope":"webhooks:manage","x-try-it":false,"x-errors":[{"status":404,"code":"NOT_FOUND","when":"No such endpoint on your account.","example":{"error":{"code":"NOT_FOUND","message":"Webhook endpoint not found","requestId":"99541a3b-ddbf-49b6-b311-1d5cb2500a3e"}}}],"parameters":[{"name":"id","in":"path","required":true,"description":"Endpoint id.","schema":{"type":"string","description":"Endpoint id (UUID)."},"example":"417b8b86-387e-4af8-a0e4-50af52e3ff81"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Removed.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"object","description":"Result.","properties":{"deleted":{"type":"boolean","description":"Always true."}},"required":["deleted"]},"example":{"deleted":true},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/webhooks/{id}/rotate-secret":{"post":{"operationId":"rotateWebhookSecret","tags":["Webhooks"],"summary":"Rotate the signing secret","description":"The old secret stops at once; the new one is in the response, shown only this once. No body.","x-scope":"webhooks:manage","x-try-it":false,"x-errors":[{"status":404,"code":"NOT_FOUND","when":"No such endpoint on your account.","example":{"error":{"code":"NOT_FOUND","message":"Webhook endpoint not found","requestId":"7053b0a4-bed6-4a14-be0e-094f1e18e497"}}}],"parameters":[{"name":"id","in":"path","required":true,"description":"Endpoint id.","schema":{"type":"string","description":"Endpoint id (UUID)."},"example":"417b8b86-387e-4af8-a0e4-50af52e3ff81"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"The endpoint with its new secret.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointWithSecret"},"example":{"id":"417b8b86-387e-4af8-a0e4-50af52e3ff81","url":"https://example.com/flyzafy-webhooks","status":"ACTIVE","events":["booking.ticketed","booking.cancelled","booking.voided"],"secretLast4":"8928","createdAt":"2026-11-15T16:31:34.459Z","updatedAt":"2026-11-15T16:31:34.500Z","secret":"<redacted>"},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/webhooks/{id}/test":{"post":{"operationId":"testWebhook","tags":["Webhooks"],"summary":"Send a test event","description":"Sends a signed `webhook.test` event to the endpoint and returns the delivery with your server's answer. No body.","x-scope":"webhooks:manage","x-try-it":false,"x-errors":[{"status":404,"code":"NOT_FOUND","when":"No such endpoint on your account.","example":{"error":{"code":"NOT_FOUND","message":"Webhook endpoint not found","requestId":"fdcb0a38-b1df-42b4-bd62-538ca4a245ce"}}}],"parameters":[{"name":"id","in":"path","required":true,"description":"Endpoint id.","schema":{"type":"string","description":"Endpoint id (UUID)."},"example":"417b8b86-387e-4af8-a0e4-50af52e3ff81"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"The delivery (DELIVERED when your server answered 2xx).","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDelivery"},"example":{"id":"evt_3c623c91e7594d2ca4113ed79d0de237","endpointId":"417b8b86-387e-4af8-a0e4-50af52e3ff81","event":"webhook.test","url":"https://example.com/flyzafy-webhooks","status":"FAILED","attempts":1,"httpStatus":405,"lastError":"HTTP 405","nextAttemptAt":null,"createdAt":"2026-11-15T16:31:34.516Z","updatedAt":"2026-11-15T16:31:34.672Z","payload":{"id":"evt_3c623c91e7594d2ca4113ed79d0de237","event":"webhook.test","data":{"message":"This is a test event."},"created_at":"2026-11-15T16:31:34.515Z"}},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/webhook-deliveries":{"get":{"operationId":"listWebhookDeliveries","tags":["Webhooks"],"summary":"List deliveries","description":"Newest first, without the payloads.","x-scope":"webhooks:manage","x-try-it":true,"x-errors":[],"parameters":[{"name":"status","in":"query","required":false,"description":"Only deliveries in this status.","schema":{"type":"string","description":"Delivery status.","enum":["PENDING","DELIVERED","FAILED"]}},{"name":"limit","in":"query","required":false,"description":"How many.","schema":{"type":"integer","description":"Count.","minimum":1,"maximum":100,"default":50},"example":"2"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"Deliveries.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"array","description":"Deliveries, newest first.","items":{"$ref":"#/components/schemas/WebhookDelivery"}},"example":[{"id":"evt_3c623c91e7594d2ca4113ed79d0de237","endpointId":"417b8b86-387e-4af8-a0e4-50af52e3ff81","event":"webhook.test","url":"https://example.com/flyzafy-webhooks","status":"FAILED","attempts":1,"httpStatus":405,"lastError":"HTTP 405","nextAttemptAt":null,"createdAt":"2026-11-15T16:31:34.516Z","updatedAt":"2026-11-15T16:31:34.672Z"}],"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/webhook-deliveries/{id}":{"get":{"operationId":"getWebhookDelivery","tags":["Webhooks"],"summary":"Get a delivery","description":"The delivery and the exact payload that was signed and sent.","x-scope":"webhooks:manage","x-try-it":true,"x-errors":[{"status":404,"code":"NOT_FOUND","when":"No such delivery on your account.","example":{"error":{"code":"NOT_FOUND","message":"Delivery not found","requestId":"7f265f11-61c3-4e25-af4e-5fe5d55c8515"}}}],"parameters":[{"name":"id","in":"path","required":true,"description":"Delivery id (= the `Webhook-Id` header).","schema":{"type":"string","description":"Delivery id.","pattern":"^evt_[0-9a-f]{32}$"},"example":"evt_3c623c91e7594d2ca4113ed79d0de237"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"The delivery.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDelivery"},"example":{"id":"evt_3c623c91e7594d2ca4113ed79d0de237","endpointId":"417b8b86-387e-4af8-a0e4-50af52e3ff81","event":"webhook.test","url":"https://example.com/flyzafy-webhooks","status":"FAILED","attempts":1,"httpStatus":405,"lastError":"HTTP 405","nextAttemptAt":null,"createdAt":"2026-11-15T16:31:34.516Z","updatedAt":"2026-11-15T16:31:34.672Z","payload":{"id":"evt_3c623c91e7594d2ca4113ed79d0de237","event":"webhook.test","data":{"message":"This is a test event."},"created_at":"2026-11-15T16:31:34.515Z"}},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}},"/webhook-deliveries/{id}/resend":{"post":{"operationId":"resendWebhookDelivery","tags":["Webhooks"],"summary":"Resend a delivery","description":"Queues the same event (same `Webhook-Id`, so your de-duplication still works) for delivery now. No body.","x-scope":"webhooks:manage","x-try-it":false,"x-errors":[{"status":404,"code":"NOT_FOUND","when":"No such delivery on your account.","example":{"error":{"code":"NOT_FOUND","message":"Delivery not found","requestId":"4da409b4-d4b8-4238-8179-9e6611dbab9b"}}}],"parameters":[{"name":"id","in":"path","required":true,"description":"Delivery id.","schema":{"type":"string","description":"Delivery id.","pattern":"^evt_[0-9a-f]{32}$"},"example":"evt_3c623c91e7594d2ca4113ed79d0de237"},{"$ref":"#/components/parameters/RequestId"}],"responses":{"200":{"description":"The delivery, PENDING again.","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDelivery"},"example":{"id":"evt_3c623c91e7594d2ca4113ed79d0de237","endpointId":"417b8b86-387e-4af8-a0e4-50af52e3ff81","event":"webhook.test","url":"https://example.com/flyzafy-webhooks","status":"PENDING","attempts":1,"httpStatus":405,"lastError":"HTTP 405","nextAttemptAt":"2026-11-15T16:32:34.777Z","createdAt":"2026-11-15T16:31:34.516Z","updatedAt":"2026-11-15T16:31:34.778Z","payload":{"id":"evt_3c623c91e7594d2ca4113ed79d0de237","event":"webhook.test","data":{"message":"This is a test event."},"created_at":"2026-11-15T16:31:34.515Z"}},"x-more-examples":[]}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"403":{"$ref":"#/components/responses/E403"},"404":{"$ref":"#/components/responses/E404"},"429":{"$ref":"#/components/responses/E429"},"500":{"$ref":"#/components/responses/E500"}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Access token from POST /security/token (30 minutes). The key it came from carries permissions (scopes): `flights:search` (Search, price and seat maps), `flights:book` (Book and issue flights), `flights:manage` (Change and cancel flight bookings), `bookings:read` (Read bookings), `webhooks:manage` (Manage webhooks)."}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"description":"A unique value per operation (e.g. a UUID). Retrying with the same value never repeats the booking or the payment.","schema":{"type":"string","description":"8–128 characters: letters, digits, `.`, `_`, `:` or `-`.","pattern":"^[A-Za-z0-9._:-]{8,128}$"},"example":"order-1001-book"},"RequestId":{"name":"X-Request-Id","in":"header","required":false,"description":"Your correlation id, echoed back and quoted in every error; one is generated when absent.","schema":{"type":"string","description":"Up to 128 characters.","maxLength":128}}},"headers":{"X-Request-Id":{"description":"The request id (yours, or one we generated).","schema":{"type":"string","description":"Request id."}},"RateLimit-Limit":{"description":"Requests allowed in the current window.","schema":{"type":"integer","description":"Limit."}},"RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer","description":"Remaining."}},"RateLimit-Reset":{"description":"Seconds until the window resets.","schema":{"type":"integer","description":"Seconds."}},"Idempotent-Replayed":{"description":"`true` when this is the stored answer of an earlier request with the same Idempotency-Key.","schema":{"type":"string","description":"Present only on replays.","enum":["true"]}}},"responses":{"E400":{"description":"Error 400. See `x-errors` on the operation and `x-common-errors` for the codes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E401":{"description":"Error 401. See `x-errors` on the operation and `x-common-errors` for the codes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E402":{"description":"Error 402. See `x-errors` on the operation and `x-common-errors` for the codes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E403":{"description":"Error 403. See `x-errors` on the operation and `x-common-errors` for the codes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E404":{"description":"Error 404. See `x-errors` on the operation and `x-common-errors` for the codes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E409":{"description":"Error 409. See `x-errors` on the operation and `x-common-errors` for the codes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E422":{"description":"Error 422. See `x-errors` on the operation and `x-common-errors` for the codes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E429":{"description":"Error 429. See `x-errors` on the operation and `x-common-errors` for the codes.","headers":{"Retry-After":{"description":"Seconds to wait.","schema":{"type":"integer","description":"Seconds."}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E500":{"description":"Error 500. See `x-errors` on the operation and `x-common-errors` for the codes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E502":{"description":"Error 502. See `x-errors` on the operation and `x-common-errors` for the codes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E503":{"description":"Error 503. See `x-errors` on the operation and `x-common-errors` for the codes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E504":{"description":"Error 504. See `x-errors` on the operation and `x-common-errors` for the codes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","description":"The error envelope of every non-2xx reply.","properties":{"error":{"type":"object","description":"The error.","properties":{"code":{"type":"string","description":"Stable machine code — branch on this, e.g. INSUFFICIENT_BALANCE."},"message":{"type":"string","description":"Human explanation (may change; do not parse)."},"requestId":{"type":"string","description":"Quote it when you contact us."},"details":{"type":"object","additionalProperties":true,"description":"Extra structured information for some codes, e.g. `fields` (INVALID_REQUEST), `requiredScope` (INSUFFICIENT_SCOPE), `retryAfterSeconds` and `limit` (RATE_LIMITED), `expectedTotal` / `newTotal` / `currency` (PRICE_CHANGED)."}},"required":["code","message","requestId"]}},"required":["error"]},"Slice":{"type":"object","description":"One city pair of a multi-city trip.","properties":{"origin":{"type":"string","description":"IATA airport or city code.","pattern":"^[A-Za-z]{3}$","minLength":3,"maxLength":3},"destination":{"type":"string","description":"IATA airport or city code.","pattern":"^[A-Za-z]{3}$","minLength":3,"maxLength":3},"departureDate":{"type":"string","description":"Local departure day, YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","format":"date"}},"required":["origin","destination","departureDate"]},"FlightSearchRequest":{"type":"object","description":"Send origin/destination/departureDate (+ returnDate), OR slices.","properties":{"origin":{"type":"string","description":"One-way / return: IATA airport or city code to fly from.","pattern":"^[A-Za-z]{3}$","minLength":3,"maxLength":3},"destination":{"type":"string","description":"One-way / return: IATA airport or city code to fly to.","pattern":"^[A-Za-z]{3}$","minLength":3,"maxLength":3},"departureDate":{"type":"string","description":"One-way / return: local departure day, YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","format":"date"},"returnDate":{"type":"string","description":"Return trip: local day of the flight back, YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","format":"date"},"slices":{"type":"array","description":"Multi-city: 2 to 6 city pairs, in order. Do not send origin/destination with it.","items":{"$ref":"#/components/schemas/Slice"},"minItems":2,"maxItems":6},"adults":{"type":"integer","description":"Travellers aged 12 and over. Default 1. Adults + children + infants with seat ≤ 9.","minimum":1,"maximum":9,"default":1},"children":{"type":"integer","description":"Children aged 2–11.","minimum":0,"maximum":8,"default":0},"infants":{"type":"integer","description":"Infants under 2 on an adult's lap (at most one per adult).","minimum":0,"maximum":9,"default":0},"infantsWithSeat":{"type":"integer","description":"Infants under 2 with their own seat.","minimum":0,"maximum":8,"default":0},"cabin":{"type":"string","description":"Cabin to search. Default ECONOMY.","enum":["ECONOMY","PREMIUM_ECONOMY","BUSINESS","FIRST"],"default":"ECONOMY"},"currency":{"type":"string","description":"Charge currency. Only USD today (see `chargeCurrencies` in GET /me).","pattern":"^[A-Za-z]{3}$"},"nonStop":{"type":"boolean","description":"Only flights without stops."},"maxConnections":{"type":"integer","description":"At most this many connections per direction (ignored with nonStop).","minimum":0,"maximum":2},"includeAirlines":{"type":"array","description":"Only these airlines (2-character IATA codes).","items":{"type":"string","description":"Airline code.","pattern":"^[A-Za-z0-9]{2}$"},"maxItems":20},"excludeAirlines":{"type":"array","description":"Never these airlines.","items":{"type":"string","description":"Airline code.","pattern":"^[A-Za-z0-9]{2}$"},"maxItems":20},"refundableOnly":{"type":"boolean","description":"Only refundable fares."},"checkedBagOnly":{"type":"boolean","description":"Only fares that include a checked bag."},"limit":{"type":"integer","description":"At most this many offers in the answer.","minimum":1,"maximum":250,"default":100}}},"Segment":{"type":"object","description":"One flight.","properties":{"id":{"type":["string","null"],"description":"Segment id, referenced by `fares[].segments[].segmentId`."},"carrier":{"type":["string","null"],"description":"Marketing airline (IATA)."},"flightNumber":{"type":["string","null"],"description":"Flight number, without the airline code."},"operatingCarrier":{"type":["string","null"],"description":"Airline that operates the flight, when it differs or is stated."},"from":{"type":"object","description":"Departure.","properties":{"airport":{"type":["string","null"],"description":"IATA airport code."},"terminal":{"type":["string","null"],"description":"Terminal; null when not stated."},"at":{"type":["string","null"],"description":"Local date and time at the airport, YYYY-MM-DDTHH:mm:ss (no time zone)."}},"required":["airport","terminal","at"]},"to":{"type":"object","description":"Arrival.","properties":{"airport":{"type":["string","null"],"description":"IATA airport code."},"terminal":{"type":["string","null"],"description":"Terminal; null when not stated."},"at":{"type":["string","null"],"description":"Local date and time at the airport, YYYY-MM-DDTHH:mm:ss (no time zone)."}},"required":["airport","terminal","at"]},"duration":{"type":["string","null"],"description":"Flight time, ISO 8601 (e.g. PT7H55M)."},"aircraft":{"type":["string","null"],"description":"IATA aircraft type code (e.g. 388 = Airbus A380)."},"stops":{"type":"integer","description":"Technical stops on this flight (not connections)."}},"required":["id","carrier","flightNumber","operatingCarrier","from","to","duration","aircraft","stops"]},"AirlineRecord":{"type":"object","description":"The booking record (PNR) as the airline system holds it now.","properties":{"found":{"type":"boolean","description":"False when the airline system no longer holds the record (voided or cancelled); the lists are then empty."},"retrievedAt":{"type":"string","description":"When it was read.","format":"date-time"},"records":{"type":"array","description":"The record locators linked to this booking: the booking PNR and the airline's own locator(s).","items":{"type":"object","description":"One linked record.","properties":{"reference":{"type":["string","null"],"description":"Record locator."},"airline":{"type":["string","null"],"description":"The airline's code when this is the airline's own locator; null for the booking PNR."},"createdAt":{"type":["string","null"],"description":"When that record was created (local, no time zone)."}},"required":["reference","airline","createdAt"]}},"travelers":{"type":"array","description":"The travellers on the record.","items":{"type":"object","description":"One traveller.","properties":{"id":{"type":["string","null"],"description":"Traveller id, as in `tickets[].travelerId`."},"firstName":{"type":["string","null"],"description":"First (and middle) name, as on the ticket."},"lastName":{"type":["string","null"],"description":"Last name, as on the ticket."},"dateOfBirth":{"type":["string","null"],"description":"YYYY-MM-DD."},"gender":{"type":["string","null"],"description":"MALE or FEMALE."}},"required":["id","firstName","lastName","dateOfBirth","gender"]}},"itineraries":{"type":"array","description":"The flights on the record, with their current status.","items":{"type":"object","description":"One direction of the trip.","properties":{"duration":{"type":["string","null"],"description":"Total duration, ISO 8601; null when not stated."},"segments":{"type":"array","description":"The flights, in order.","items":{"type":"object","description":"One flight, as the airline holds it now.","properties":{"id":{"type":["string","null"],"description":"Segment id, referenced by `fares[].segments[].segmentId`."},"carrier":{"type":["string","null"],"description":"Marketing airline (IATA)."},"flightNumber":{"type":["string","null"],"description":"Flight number, without the airline code."},"operatingCarrier":{"type":["string","null"],"description":"Airline that operates the flight, when it differs or is stated."},"from":{"type":"object","description":"Departure.","properties":{"airport":{"type":["string","null"],"description":"IATA airport code."},"terminal":{"type":["string","null"],"description":"Terminal; null when not stated."},"at":{"type":["string","null"],"description":"Local date and time at the airport, YYYY-MM-DDTHH:mm:ss (no time zone)."}},"required":["airport","terminal","at"]},"to":{"type":"object","description":"Arrival.","properties":{"airport":{"type":["string","null"],"description":"IATA airport code."},"terminal":{"type":["string","null"],"description":"Terminal; null when not stated."},"at":{"type":["string","null"],"description":"Local date and time at the airport, YYYY-MM-DDTHH:mm:ss (no time zone)."}},"required":["airport","terminal","at"]},"duration":{"type":["string","null"],"description":"Flight time, ISO 8601 (e.g. PT7H55M)."},"aircraft":{"type":["string","null"],"description":"IATA aircraft type code (e.g. 388 = Airbus A380)."},"stops":{"type":"integer","description":"Technical stops on this flight (not connections)."},"status":{"type":["string","null"],"description":"Seat status: CONFIRMED, WAITLISTED, CANCELLED, PENDING or DENIED.","enum":["CONFIRMED","WAITLISTED","CANCELLED","PENDING","DENIED",null]},"type":{"type":["string","null"],"description":"Segment type: ACTIVE, PASSIVE, GHOST or STAFF.","enum":["ACTIVE","PASSIVE","GHOST","STAFF",null]},"flown":{"type":["boolean","null"],"description":"True once the flight has been flown."}},"required":["id","carrier","flightNumber","operatingCarrier","from","to","duration","aircraft","stops","status","type","flown"]}}},"required":["duration","segments"]}},"tickets":{"type":"array","description":"The documents on the record.","items":{"type":"object","description":"One document.","properties":{"number":{"type":["string","null"],"description":"Document number (airline code + number)."},"type":{"type":["string","null"],"description":"ETICKET, PTICKET, EMD or MCO.","enum":["ETICKET","PTICKET","EMD","MCO",null]},"status":{"type":["string","null"],"description":"ISSUED, REFUNDED, VOID, ORIGINAL or EXCHANGED.","enum":["ISSUED","REFUNDED","VOID","ORIGINAL","EXCHANGED",null]},"travelerId":{"type":["string","null"],"description":"The traveller it belongs to."},"segmentIds":{"type":"array","description":"The flights it covers (`segments[].id`).","items":{"type":"string","description":"Segment id."}},"issuedAt":{"type":["string","null"],"description":"When it was issued."}},"required":["number","type","status","travelerId","segmentIds","issuedAt"]}}},"required":["found","retrievedAt","records","travelers","itineraries","tickets"]},"FlightOffer":{"type":"object","description":"A flight offer.","properties":{"offerId":{"type":"string","description":"Use it to price the offer. Valid until the search `expiresAt`. On a priced offer this is the `pricedOfferId`."},"groupId":{"type":"string","description":"Offers with the same flights share a group (fare families of one flight). `priced` on a priced offer."},"validatingCarrier":{"type":["string","null"],"description":"Airline that issues the ticket."},"lastTicketingDate":{"type":["string","null"],"description":"Last day the fare can be ticketed, YYYY-MM-DD; null when not stated."},"seatsAvailable":{"type":["integer","null"],"description":"Seats left at this price; null when not stated."},"price":{"type":"object","description":"What your wallet pays for all travellers.","properties":{"currency":{"type":"string","description":"ISO 4217 code."},"total":{"type":"string","description":"Total price. A decimal string with 2 decimals.","pattern":"^-?\\d+\\.\\d{2}$","examples":["848.80"]},"base":{"type":["string","null"],"description":"Fare without taxes; null when the split is unknown. A decimal string with 2 decimals.","pattern":"^-?\\d+\\.\\d{2}$","examples":["848.80"]},"taxes":{"type":["string","null"],"description":"Airline taxes and fees; null when unknown. A decimal string with 2 decimals.","pattern":"^-?\\d+\\.\\d{2}$","examples":["848.80"]}},"required":["currency","total","base","taxes"]},"itineraries":{"type":"array","description":"One per direction (or per multi-city pair).","items":{"type":"object","description":"One direction of the trip (outbound, return, or one city pair of a multi-city).","properties":{"duration":{"type":["string","null"],"description":"Total duration, ISO 8601 (e.g. PT8H); null when the airline does not state it."},"segments":{"type":"array","description":"The flights, in order.","items":{"$ref":"#/components/schemas/Segment"}}},"required":["duration","segments"]}},"fares":{"type":"array","description":"The fare of each traveller.","items":{"type":"object","description":"One traveller.","properties":{"travelerId":{"type":["string","null"],"description":"Traveller id: send it as `travelers[].id` when booking."},"travelerType":{"type":["string","null"],"description":"ADULT, CHILD, HELD_INFANT, SEATED_INFANT…"},"total":{"type":["string","null"],"description":"This traveller's price. A decimal string with 2 decimals.","pattern":"^-?\\d+\\.\\d{2}$","examples":["848.80"]},"segments":{"type":"array","description":"Fare details per flight.","items":{"type":"object","description":"Fare on one flight.","properties":{"segmentId":{"type":["string","null"],"description":"The `segments[].id` it applies to."},"cabin":{"type":["string","null"],"description":"ECONOMY, PREMIUM_ECONOMY, BUSINESS or FIRST."},"bookingClass":{"type":["string","null"],"description":"Booking class (one letter)."},"fareBasis":{"type":["string","null"],"description":"Fare basis code."},"brand":{"type":["string","null"],"description":"Branded fare code (e.g. ECOFLEX)."},"brandLabel":{"type":["string","null"],"description":"Branded fare name (e.g. Economy Flex)."},"checkedBags":{"type":["object","null"],"description":"Checked baggage included in the fare; null when the airline states none.","properties":{"quantity":{"type":["integer","null"],"description":"Number of pieces; null when stated by weight."},"weight":{"type":["integer","null"],"description":"Weight allowance; null when stated in pieces."},"weightUnit":{"type":["string","null"],"description":"KG or LB."}},"required":["quantity","weight","weightUnit"]},"cabinBags":{"type":["object","null"],"description":"Cabin baggage included in the fare; null when the airline states none.","properties":{"quantity":{"type":["integer","null"],"description":"Number of pieces; null when stated by weight."},"weight":{"type":["integer","null"],"description":"Weight allowance; null when stated in pieces."},"weightUnit":{"type":["string","null"],"description":"KG or LB."}},"required":["quantity","weight","weightUnit"]}},"required":["segmentId","cabin","bookingClass","fareBasis","brand","brandLabel","checkedBags","cabinBags"]}}},"required":["travelerId","travelerType","total","segments"]}}},"required":["offerId","groupId","validatingCarrier","lastTicketingDate","seatsAvailable","price","itineraries","fares"]},"FlightSearchResult":{"type":"object","description":"Search answer.","properties":{"searchId":{"type":"string","description":"This search (the offers belong to it)."},"expiresAt":{"type":"string","description":"When the offer ids stop working (20 minutes).","format":"date-time"},"count":{"type":"integer","description":"Number of offers returned."},"offers":{"type":"array","description":"Offers, cheapest first.","items":{"$ref":"#/components/schemas/FlightOffer"}},"partial":{"type":"boolean","description":"Present and true when part of the search could not be completed; the offers returned are still valid."},"warnings":{"type":"array","description":"Why the result is partial. Present only with `partial`.","items":{"type":"object","description":"A warning.","properties":{"code":{"type":["integer","null"],"description":"Warning code."},"title":{"type":["string","null"],"description":"Warning title."}}}}},"required":["searchId","expiresAt","count","offers"]},"TokenResponse":{"type":"object","description":"An access token (OAuth2 client-credentials answer).","properties":{"token_type":{"type":"string","description":"Always `Bearer`.","enum":["Bearer"]},"access_token":{"type":"string","description":"Send it as `Authorization: Bearer <access_token>` on every other call. Keep it secret."},"expires_in":{"type":"integer","description":"Seconds it stays valid (1799 = 30 minutes). Get a new one before it ends."},"scope":{"type":"string","description":"The permissions of the key, space-separated."}},"required":["token_type","access_token","expires_in","scope"]},"AvailabilityRequest":{"type":"object","description":"What to check: 1–6 slices and the travellers.","properties":{"slices":{"type":"array","description":"The flights to check, in travel order.","items":{"type":"object","description":"One slice.","properties":{"origin":{"type":"string","description":"IATA airport or city code.","pattern":"^[A-Za-z]{3}$","minLength":3,"maxLength":3},"destination":{"type":"string","description":"IATA airport or city code.","pattern":"^[A-Za-z]{3}$","minLength":3,"maxLength":3},"departureDate":{"type":"string","description":"Local departure day, YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","format":"date"},"departureTime":{"type":"string","description":"Earliest local departure time, HH:MM or HH:MM:SS.","pattern":"^\\d{2}:\\d{2}(:\\d{2})?$"}},"required":["origin","destination","departureDate"]},"minItems":1,"maxItems":6},"adults":{"type":"integer","description":"Adults (12+).","minimum":1,"maximum":9,"default":1},"children":{"type":"integer","description":"Children 2–11.","minimum":0,"maximum":8,"default":0},"infants":{"type":"integer","description":"Infants under 2 on an adult’s lap.","minimum":0,"maximum":9,"default":0},"cabin":{"type":"string","description":"Cabin.","enum":["ECONOMY","PREMIUM_ECONOMY","BUSINESS","FIRST"]},"includeAirlines":{"type":"array","description":"Only these airlines (IATA codes).","items":{"type":"string","description":"Airline code.","pattern":"^[A-Za-z0-9]{2}$"},"maxItems":20},"excludeAirlines":{"type":"array","description":"Never these airlines (IATA codes).","items":{"type":"string","description":"Airline code.","pattern":"^[A-Za-z0-9]{2}$"},"maxItems":20},"maxConnections":{"type":"integer","description":"At most this many connections (0–2).","minimum":0,"maximum":2}},"required":["slices"]},"AvailabilityResult":{"type":"object","description":"The flights with seats per booking class.","properties":{"count":{"type":"integer","description":"Number of flights."},"flights":{"type":"array","description":"Flights, in the order the airline system lists them.","items":{"type":"object","description":"One flight option for one slice.","properties":{"id":{"type":["string","null"],"description":"Option id."},"slice":{"type":"integer","description":"Which slice it answers (0 = the first)."},"instantTicketingRequired":{"type":"boolean","description":"True when the airline requires ticketing right after booking."},"duration":{"type":["string","null"],"description":"Total duration, ISO 8601 (e.g. PT10H15M)."},"segments":{"type":"array","description":"The flights of this option, in order.","items":{"type":"object","description":"One flight.","properties":{"id":{"type":["string","null"],"description":"Segment id."},"carrier":{"type":["string","null"],"description":"Marketing airline (IATA)."},"flightNumber":{"type":["string","null"],"description":"Flight number, without the airline code."},"operatingCarrier":{"type":["string","null"],"description":"Operating airline, when stated."},"from":{"type":"object","description":"Departure.","properties":{"airport":{"type":["string","null"],"description":"IATA airport code."},"terminal":{"type":["string","null"],"description":"Terminal; null when not stated."},"at":{"type":["string","null"],"description":"Local date and time at the airport, YYYY-MM-DDTHH:mm:ss (no time zone)."}},"required":["airport","terminal","at"]},"to":{"type":"object","description":"Arrival.","properties":{"airport":{"type":["string","null"],"description":"IATA airport code."},"terminal":{"type":["string","null"],"description":"Terminal; null when not stated."},"at":{"type":["string","null"],"description":"Local date and time at the airport, YYYY-MM-DDTHH:mm:ss (no time zone)."}},"required":["airport","terminal","at"]},"aircraft":{"type":["string","null"],"description":"IATA aircraft type code."},"stops":{"type":"integer","description":"Technical stops on this flight."},"classes":{"type":"array","description":"Seats left per booking class.","items":{"type":"object","description":"One booking class.","properties":{"bookingClass":{"type":["string","null"],"description":"Booking class (RBD), e.g. Y."},"seats":{"type":["integer","null"],"description":"Seats bookable in that class (at most 9 are shown)."}},"required":["bookingClass","seats"]}}},"required":["id","carrier","flightNumber","operatingCarrier","from","to","aircraft","stops","classes"]}}},"required":["id","slice","instantTicketingRequired","duration","segments"]}}},"required":["count","flights"]},"PricedOffer":{"type":"object","description":"A live-priced offer, ready to book.","properties":{"pricedOfferId":{"type":"string","description":"Send it to POST /flights/bookings (or upsell, extras, seat maps)."},"expiresAt":{"type":["string","null"],"description":"When it must be booked by.","format":"date-time"},"offer":{"$ref":"#/components/schemas/FlightOffer","description":"The offer at the live price (extras included)."},"penalties":{"type":"array","description":"Change and cancellation rules from the fare.","items":{"type":"object","description":"One rule.","properties":{"type":{"type":"string","description":"CHANGE or CANCELLATION.","enum":["CHANGE","CANCELLATION"]},"label":{"type":"string","description":"Human description."},"amount":{"type":["number","null"],"description":"Penalty amount (a JSON number); null when not stated."},"currency":{"type":["string","null"],"description":"Currency of `amount`."},"applicable":{"type":"boolean","description":"False when the action is not allowed at all."},"circumstances":{"type":"string","description":"When the rule applies (e.g. before departure), when the airline states it."}},"required":["type","label","amount","currency","applicable"]}},"fareRules":{"type":"array","description":"The detailed fare rules, one entry per fare component.","items":{"type":"object","description":"One fare component.","properties":{"fareComponent":{"type":"string","description":"Fare component number."},"segmentId":{"type":["string","null"],"description":"The first flight it covers."},"fareBasis":{"type":["string","null"],"description":"Fare basis code."},"name":{"type":["string","null"],"description":"Fare name, e.g. Economy Flex Plus."},"rules":{"type":"array","description":"The rule texts.","items":{"type":"object","description":"One rule text.","properties":{"type":{"type":["string","null"],"description":"Rule type, e.g. PENALTIES, TICKET ENDORSMENT (as the airline spells it)."},"text":{"type":["string","null"],"description":"The airline’s text."}},"required":["type","text"]}}},"required":["fareComponent","segmentId","fareBasis","name","rules"]}},"bagOptions":{"type":"array","description":"Extra checked bags the airline sells for this offer. Add them with POST …/extras.","items":{"type":"object","description":"One extra-bag option (the price is the airline’s, passed through).","properties":{"key":{"type":"string","description":"Option number."},"quantity":{"type":["integer","null"],"description":"Bags."},"weight":{"type":["integer","null"],"description":"Weight per bag, when stated."},"weightUnit":{"type":["string","null"],"description":"KG or LB."},"price":{"type":"object","description":"Price of the option.","properties":{"amount":{"type":["string","null"],"description":"Amount. A decimal string with 2 decimals.","pattern":"^-?\\d+\\.\\d{2}$","examples":["848.80"]},"currency":{"type":["string","null"],"description":"ISO 4217 code."}},"required":["amount","currency"]},"perItinerary":{"type":"boolean","description":"True when it is bought per direction rather than for the whole trip."},"segmentIds":{"type":"array","description":"Flights it covers.","items":{"type":"string","description":"Segment id."}},"travelerIds":{"type":"array","description":"Travellers it applies to.","items":{"type":"string","description":"Traveller id."}}},"required":["key","quantity","weight","weightUnit","price","perItinerary","segmentIds","travelerIds"]}},"extras":{"$ref":"#/components/schemas/Extras","description":"The seats and bags added with POST …/extras."},"bookingRequirements":{"type":["object","null"],"description":"What the booking must contain; null when the airline states nothing.","properties":{"emailAddressRequired":{"type":"boolean","description":"The contact must have an email (always sent)."},"mobilePhoneNumberRequired":{"type":"boolean","description":"The contact must have a mobile phone (always sent)."},"phoneNumberRequired":{"type":"boolean","description":"The contact must have a phone number (always sent)."},"travelerRequirements":{"type":"array","description":"Per traveller.","items":{"type":"object","description":"One traveller.","properties":{"travelerId":{"type":"string","description":"Traveller id."},"documentRequired":{"type":"boolean","description":"Passport/ID fields are required for this traveller."},"genderRequired":{"type":"boolean","description":"`gender` must be MALE or FEMALE."},"dateOfBirthRequired":{"type":"boolean","description":"`dateOfBirth` is required."},"redressRequiredIfAny":{"type":"boolean","description":"A redress number must be sent if the traveller has one."},"residenceRequired":{"type":"boolean","description":"An address is required."}}}}}},"holdAllowed":{"type":"object","description":"Can this fare be booked with `ticketing: HOLD`?","properties":{"allowed":{"type":"boolean","description":"True when a hold is possible."},"reason":{"type":["string","null"],"description":"Why not; null when allowed."}},"required":["allowed","reason"]}},"required":["pricedOfferId","expiresAt","offer","penalties","fareRules","bagOptions","extras","bookingRequirements","holdAllowed"]},"PricedOfferWithExtras":{"allOf":[{"$ref":"#/components/schemas/PricedOffer"},{"type":"object","description":"Seats the airline would not add.","properties":{"droppedSeats":{"type":"array","description":"Present only when a seat was left off.","items":{"type":"object","description":"One seat.","properties":{"seatNumber":{"type":"string","description":"The seat."},"reason":{"type":"string","description":"Why it was not added."}},"required":["seatNumber","reason"]}}}}],"description":"The priced offer at the new total."},"Extras":{"type":"object","description":"Seats and bags on a priced offer.","properties":{"seats":{"type":"array","description":"Seats chosen.","items":{"type":"object","description":"One seat.","properties":{"travelerId":{"type":["string","null"],"description":"Traveller."},"segmentId":{"type":["string","null"],"description":"Flight (segment id)."},"seatNumber":{"type":["string","null"],"description":"Seat, e.g. 18C."}},"required":["travelerId","segmentId","seatNumber"]}},"bags":{"type":"array","description":"Extra bags chosen.","items":{"type":"object","description":"Per traveller.","properties":{"travelerId":{"type":"string","description":"Traveller."},"quantity":{"type":"integer","description":"Extra bags on every flight."}},"required":["travelerId","quantity"]}}},"required":["seats","bags"]},"ExtrasRequest":{"type":"object","description":"The seats and bags to add. Replaces any earlier choice; an empty body removes them.","properties":{"seats":{"type":"array","description":"Paid or free seats from GET …/seatmaps (one per traveller per flight).","items":{"$ref":"#/components/schemas/SeatPick"},"maxItems":54},"bags":{"type":"array","description":"Extra checked bags per traveller, on every flight.","items":{"type":"object","description":"One traveller.","properties":{"travelerId":{"type":"string","description":"`offer.fares[].travelerId`.","maxLength":8},"quantity":{"type":"integer","description":"Extra bags.","minimum":1,"maximum":5}},"required":["travelerId","quantity"]},"maxItems":9}}},"SeatPick":{"type":"object","description":"One seat for one traveller on one flight.","properties":{"travelerId":{"type":"string","description":"Traveller id.","maxLength":8},"segmentId":{"type":"string","description":"Flight (`flights[].segmentId` of the seat map).","maxLength":16},"seatNumber":{"type":"string","description":"Seat, e.g. 12A.","pattern":"^\\d{1,3}[A-Za-z]$"}},"required":["travelerId","segmentId","seatNumber"]},"SeatMaps":{"type":"object","description":"Seat maps.","properties":{"available":{"type":"boolean","description":"False when the airline shows no seat map now (see `reason`)."},"reason":{"type":["string","null"],"description":"Why there is no seat map; null when there is one."},"flights":{"type":"array","description":"One seat map per flight.","items":{"type":"object","description":"One flight.","properties":{"segmentId":{"type":"string","description":"Flight (segment id) — send it in a seat pick."},"carrier":{"type":["string","null"],"description":"Airline (IATA)."},"flightNumber":{"type":["string","null"],"description":"Flight number."},"from":{"type":"object","description":"Departure.","properties":{"airport":{"type":["string","null"],"description":"IATA airport."},"at":{"type":["string","null"],"description":"Local time."}},"required":["airport","at"]},"to":{"type":"object","description":"Arrival.","properties":{"airport":{"type":["string","null"],"description":"IATA airport."},"at":{"type":["string","null"],"description":"Local time."}},"required":["airport","at"]},"aircraft":{"type":["string","null"],"description":"IATA aircraft type code."},"bookingClass":{"type":["string","null"],"description":"Booking class the map was shown for."},"availableSeats":{"type":"array","description":"Free-to-take seats per traveller.","items":{"type":"object","description":"One traveller.","properties":{"travelerId":{"type":"string","description":"Traveller."},"count":{"type":"integer","description":"Seats."}},"required":["travelerId","count"]}},"decks":{"type":"array","description":"Decks of the aircraft.","items":{"type":"object","description":"One deck.","properties":{"deckType":{"type":["string","null"],"description":"UPPER, MAIN or LOWER."},"facilities":{"type":"array","description":"Lavatories, galleys, exits… (codes in `facilities`).","items":{"type":"object","description":"One facility.","properties":{"code":{"type":"string","description":"Facility code."},"row":{"type":["string","null"],"description":"Row."},"column":{"type":["string","null"],"description":"Column."},"position":{"type":["string","null"],"description":"FRONT, REAR or SEAT."}},"required":["code","row","column","position"]}},"seats":{"type":"array","description":"Seats.","items":{"type":"object","description":"One seat.","properties":{"number":{"type":"string","description":"Seat, e.g. 12A."},"row":{"type":["integer","null"],"description":"Row number."},"column":{"type":"string","description":"Column letter."},"cabin":{"type":["string","null"],"description":"Cabin of the seat."},"characteristics":{"type":"array","description":"Seat codes (labels in `characteristics`).","items":{"type":"string","description":"Code."}},"window":{"type":"boolean","description":"Window seat."},"aisle":{"type":"boolean","description":"Aisle seat."},"exitRow":{"type":"boolean","description":"Exit-row seat."},"travelers":{"type":"array","description":"Per traveller.","items":{"type":"object","description":"One traveller.","properties":{"travelerId":{"type":"string","description":"Traveller."},"status":{"type":"string","description":"AVAILABLE, BLOCKED or OCCUPIED.","enum":["AVAILABLE","BLOCKED","OCCUPIED"]},"price":{"type":["object","null"],"description":"Selling price; null for a free seat (or one the airline did not price).","properties":{"currency":{"type":"string","description":"ISO 4217 code."},"total":{"type":["string","null"],"description":"Price. A decimal string with 2 decimals.","pattern":"^-?\\d+\\.\\d{2}$","examples":["848.80"]}},"required":["currency","total"]}},"required":["travelerId","status","price"]}}},"required":["number","row","column","cabin","characteristics","window","aisle","exitRow","travelers"]}}},"required":["deckType","facilities","seats"]}}},"required":["segmentId","carrier","flightNumber","from","to","aircraft","bookingClass","availableSeats","decks"]}},"characteristics":{"type":"object","additionalProperties":true,"description":"Seat code → label, e.g. {\"W\": \"Window\"}."},"facilities":{"type":"object","additionalProperties":true,"description":"Facility code → label, e.g. {\"LA\": \"Lavatory\"}."}},"required":["available","reason","flights","characteristics","facilities"]},"BookingSeatMaps":{"type":"object","description":"Seat maps of a booking.","properties":{"available":{"type":"boolean","description":"False when the airline shows no seat map now (see `reason`)."},"reason":{"type":["string","null"],"description":"Why there is no seat map; null when there is one."},"canAddSeats":{"type":"boolean","description":"True while paid seats can be added (held, unpaid booking)."},"addSeatsNote":{"type":["string","null"],"description":"Why seats cannot be added; null when they can."},"flights":{"type":"array","description":"One seat map per flight.","items":{"type":"object","description":"One flight.","properties":{"segmentId":{"type":"string","description":"Flight (segment id) — send it in a seat pick."},"carrier":{"type":["string","null"],"description":"Airline (IATA)."},"flightNumber":{"type":["string","null"],"description":"Flight number."},"from":{"type":"object","description":"Departure.","properties":{"airport":{"type":["string","null"],"description":"IATA airport."},"at":{"type":["string","null"],"description":"Local time."}},"required":["airport","at"]},"to":{"type":"object","description":"Arrival.","properties":{"airport":{"type":["string","null"],"description":"IATA airport."},"at":{"type":["string","null"],"description":"Local time."}},"required":["airport","at"]},"aircraft":{"type":["string","null"],"description":"IATA aircraft type code."},"bookingClass":{"type":["string","null"],"description":"Booking class the map was shown for."},"availableSeats":{"type":"array","description":"Free-to-take seats per traveller.","items":{"type":"object","description":"One traveller.","properties":{"travelerId":{"type":"string","description":"Traveller."},"count":{"type":"integer","description":"Seats."}},"required":["travelerId","count"]}},"decks":{"type":"array","description":"Decks of the aircraft.","items":{"type":"object","description":"One deck.","properties":{"deckType":{"type":["string","null"],"description":"UPPER, MAIN or LOWER."},"facilities":{"type":"array","description":"Lavatories, galleys, exits… (codes in `facilities`).","items":{"type":"object","description":"One facility.","properties":{"code":{"type":"string","description":"Facility code."},"row":{"type":["string","null"],"description":"Row."},"column":{"type":["string","null"],"description":"Column."},"position":{"type":["string","null"],"description":"FRONT, REAR or SEAT."}},"required":["code","row","column","position"]}},"seats":{"type":"array","description":"Seats.","items":{"type":"object","description":"One seat.","properties":{"number":{"type":"string","description":"Seat, e.g. 12A."},"row":{"type":["integer","null"],"description":"Row number."},"column":{"type":"string","description":"Column letter."},"cabin":{"type":["string","null"],"description":"Cabin of the seat."},"characteristics":{"type":"array","description":"Seat codes (labels in `characteristics`).","items":{"type":"string","description":"Code."}},"window":{"type":"boolean","description":"Window seat."},"aisle":{"type":"boolean","description":"Aisle seat."},"exitRow":{"type":"boolean","description":"Exit-row seat."},"travelers":{"type":"array","description":"Per traveller.","items":{"type":"object","description":"One traveller.","properties":{"travelerId":{"type":"string","description":"Traveller."},"status":{"type":"string","description":"AVAILABLE, BLOCKED or OCCUPIED.","enum":["AVAILABLE","BLOCKED","OCCUPIED"]},"price":{"type":["object","null"],"description":"Selling price; null for a free seat (or one the airline did not price).","properties":{"currency":{"type":"string","description":"ISO 4217 code."},"total":{"type":["string","null"],"description":"Price. A decimal string with 2 decimals.","pattern":"^-?\\d+\\.\\d{2}$","examples":["848.80"]}},"required":["currency","total"]}},"required":["travelerId","status","price"]}}},"required":["number","row","column","cabin","characteristics","window","aisle","exitRow","travelers"]}}},"required":["deckType","facilities","seats"]}}},"required":["segmentId","carrier","flightNumber","from","to","aircraft","bookingClass","availableSeats","decks"]}},"characteristics":{"type":"object","additionalProperties":true,"description":"Seat code → label, e.g. {\"W\": \"Window\"}."},"facilities":{"type":"object","additionalProperties":true,"description":"Facility code → label, e.g. {\"LA\": \"Lavatory\"}."}},"required":["available","reason","canAddSeats","addSeatsNote","flights","characteristics","facilities"]},"BookingResult":{"type":"object","description":"The booking and the ticketing result.","properties":{"booking":{"$ref":"#/components/schemas/FlightBooking","description":"The booking."},"issue":{"anyOf":[{"$ref":"#/components/schemas/IssueResult","description":"Ticketing result; null for a HOLD (or a booking our team is confirming)."},{"type":"null"}],"description":"Ticketing result; null for a HOLD (or a booking our team is confirming)."}},"required":["booking","issue"]},"IssueResult":{"type":"object","description":"What happened when the ticket was issued.","properties":{"status":{"type":"string","description":"ISSUED (ticketed and charged), PENDING (charged; the airline has not confirmed yet, retried automatically) or REFUSED (nothing charged; the booking stays held).","enum":["ISSUED","PENDING","REFUSED"]},"code":{"type":["string","null"],"description":"Why it was refused (same codes as the issue errors); null otherwise."},"message":{"type":["string","null"],"description":"Explanation for PENDING and REFUSED; null when issued."},"charged":{"type":["object","null"],"description":"What your wallet was charged; null when nothing was.","properties":{"amount":{"type":"string","description":"Charged. A decimal string with 2 decimals.","pattern":"^-?\\d+\\.\\d{2}$","examples":["848.80"]},"currency":{"type":"string","description":"ISO 4217 code."}},"required":["amount","currency"]},"details":{"type":"object","additionalProperties":true,"description":"Extra information for some refusals (e.g. both totals for PRICE_CHANGED)."}},"required":["status","code","message","charged"]},"BookingRead":{"type":"object","description":"Our record of the booking and the airline record read live.","properties":{"booking":{"$ref":"#/components/schemas/FlightBooking","description":"Our record (price, what was charged, tickets)."},"airlineRecord":{"$ref":"#/components/schemas/AirlineRecord","description":"The record as the airline system holds it now."},"bagOptions":{"type":"array","description":"With `include=bags`: extra bags the airline sells for this booking.","items":{"type":"object","description":"One extra-bag option (the price is the airline’s, passed through).","properties":{"key":{"type":"string","description":"Option number."},"quantity":{"type":["integer","null"],"description":"Bags."},"weight":{"type":["integer","null"],"description":"Weight per bag, when stated."},"weightUnit":{"type":["string","null"],"description":"KG or LB."},"price":{"type":"object","description":"Price of the option.","properties":{"amount":{"type":["string","null"],"description":"Amount. A decimal string with 2 decimals.","pattern":"^-?\\d+\\.\\d{2}$","examples":["848.80"]},"currency":{"type":["string","null"],"description":"ISO 4217 code."}},"required":["amount","currency"]},"perItinerary":{"type":"boolean","description":"True when it is bought per direction rather than for the whole trip."},"segmentIds":{"type":"array","description":"Flights it covers.","items":{"type":"string","description":"Segment id."}},"travelerIds":{"type":"array","description":"Travellers it applies to.","items":{"type":"string","description":"Traveller id."}}},"required":["key","quantity","weight","weightUnit","price","perItinerary","segmentIds","travelerIds"]}},"airlineFareRules":{"type":"array","description":"With `fareRules=…`: the airline’s refund and change rules for this booking.","items":{"type":"object","description":"One rule.","properties":{"category":{"type":["string","null"],"description":"REFUND, EXCHANGE, REVALIDATION, REISSUE, REBOOK or CANCELLATION."},"notApplicable":{"type":"boolean","description":"True when the action is not allowed."},"maxPenaltyAmount":{"type":["string","null"],"description":"Largest penalty. A decimal string with 2 decimals.","pattern":"^-?\\d+\\.\\d{2}$","examples":["848.80"]},"currency":{"type":["string","null"],"description":"Currency of the penalty."}},"required":["category","notApplicable","maxPenaltyAmount","currency"]}}},"required":["booking","airlineRecord"]},"BookingUpdateRequest":{"type":"object","description":"Send seats, travelers, or both.","properties":{"seats":{"type":"array","description":"Paid seats to add (before the ticket is issued).","items":{"$ref":"#/components/schemas/SeatPick"},"minItems":1,"maxItems":54},"travelers":{"type":"array","description":"Travel documents to add.","items":{"type":"object","description":"One traveller.","properties":{"id":{"type":"string","description":"Traveller id (`airlineRecord.travelers[].id`).","maxLength":8},"documents":{"type":"array","description":"Documents.","items":{"type":"object","description":"One document.","properties":{"documentType":{"type":"string","description":"Document type.","enum":["PASSPORT","IDENTITY_CARD","VISA"]},"number":{"type":"string","description":"Document number (letters and digits).","pattern":"^[A-Za-z0-9]{1,20}$"},"expiryDate":{"type":"string","description":"Expiry, YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","format":"date"},"issuanceCountry":{"type":"string","description":"ISO 3166-1 alpha-2 country that issued it.","pattern":"^[A-Za-z]{2}$"},"nationality":{"type":"string","description":"ISO 3166-1 alpha-2 nationality on it.","pattern":"^[A-Za-z]{2}$"},"issuanceDate":{"type":"string","description":"Issue date, YYYY-MM-DD.","pattern":"^\\d{4}-\\d{2}-\\d{2}$","format":"date"},"issuanceLocation":{"type":"string","description":"Place of issue.","maxLength":35},"birthPlace":{"type":"string","description":"Place of birth as on the document.","maxLength":35},"holder":{"type":"boolean","description":"True when the traveller holds the document (default true)."}},"required":["documentType","number","expiryDate","issuanceCountry","nationality"]},"minItems":1,"maxItems":3}},"required":["id","documents"]},"minItems":1,"maxItems":9}}},"CancellationResult":{"type":"object","description":"The booking and what happened to the money.","properties":{"booking":{"$ref":"#/components/schemas/FlightBooking","description":"The booking after the cancellation."},"cancellation":{"type":"object","description":"What was done.","properties":{"type":{"type":"string","description":"VOID (ticket withdrawn) or CANCEL.","enum":["VOID","CANCEL"]},"refund":{"type":"string","description":"FULL (all back to your wallet now), NONE (nothing was charged) or AFTER_AIRLINE_REFUND (fare minus penalty, once the airline has processed the refund).","enum":["FULL","NONE","AFTER_AIRLINE_REFUND"]},"message":{"type":"string","description":"Explanation."}},"required":["type","refund","message"]}},"required":["booking","cancellation"]},"Traveler":{"type":"object","description":"A traveller, exactly as on the passport.","properties":{"id":{"type":"string","description":"`travelerId` from the priced offer (`offer.fares[].travelerId`).","maxLength":20},"title":{"type":"string","description":"Title, e.g. MR, MRS, MS, MISS.","maxLength":20},"firstName":{"type":"string","description":"Given name as on the passport (Latin letters).","maxLength":60},"middleName":{"type":"string","description":"Middle name(s); sent to the airline joined to the first name.","maxLength":60},"lastName":{"type":"string","description":"Surname as on the passport.","maxLength":60},"gender":{"type":"string","description":"MALE or FEMALE (UNDISCLOSED is accepted where the airline allows it).","maxLength":20,"examples":["FEMALE"]},"dateOfBirth":{"type":"string","description":"YYYY-MM-DD.","maxLength":32,"pattern":"^\\d{4}-\\d{2}-\\d{2}$","format":"date"},"passportNumber":{"type":"string","description":"Document number. Required when the priced offer says `documentRequired`.","maxLength":20},"documentExpiryDate":{"type":"string","description":"Document expiry, YYYY-MM-DD.","maxLength":32,"pattern":"^\\d{4}-\\d{2}-\\d{2}$","format":"date"},"nationality":{"type":"string","description":"ISO 3166-1 alpha-2 nationality on the document.","maxLength":3},"issuanceCountry":{"type":"string","description":"ISO 3166-1 alpha-2 country that issued the document (default: nationality).","maxLength":3},"documentType":{"type":"string","description":"PASSPORT (default), IDENTITY_CARD, VISA, KNOWN_TRAVELER or REDRESS.","maxLength":20},"issuanceDate":{"type":"string","description":"Document issue date, YYYY-MM-DD.","maxLength":32},"birthPlace":{"type":"string","description":"Place of birth as on the document.","maxLength":60},"issuanceLocation":{"type":"string","description":"Place of issue as on the document (e.g. New York).","maxLength":60}},"required":["id","title","firstName","lastName","gender","dateOfBirth"]},"Contact":{"type":"object","description":"Who the airline contacts about the booking.","properties":{"name":{"type":"string","description":"Contact name.","maxLength":130},"email":{"type":"string","description":"Email that receives mail (throwaway inboxes are refused).","maxLength":254,"format":"email"},"phone":{"type":"string","description":"Mobile number in international format, e.g. +14155550123.","maxLength":32},"address":{"type":"object","description":"Postal address, when the airline needs one.","properties":{"lines":{"type":"array","description":"Street lines.","items":{"type":"string","description":"One line.","maxLength":70},"maxItems":4},"postalCode":{"type":"string","description":"Postal code.","maxLength":20},"cityName":{"type":"string","description":"City.","maxLength":60},"countryCode":{"type":"string","description":"ISO 3166-1 alpha-2 country.","maxLength":3},"stateName":{"type":"string","description":"State or province.","maxLength":60}}}},"required":["name","email","phone"]},"FlightBookingRequest":{"type":"object","description":"Book a priced offer.","properties":{"pricedOfferId":{"type":"string","description":"From Price an offer (or Add seats and bags).","maxLength":64},"ticketing":{"type":"string","description":"HOLD = book now and issue later with POST /flights/bookings/{id}/issue (nothing charged); ISSUE = book and issue now (charged when issued). Check `holdAllowed` on the priced offer before HOLD.","enum":["HOLD","ISSUE"]},"travelers":{"type":"array","description":"Every traveller of the priced offer.","items":{"$ref":"#/components/schemas/Traveler"},"minItems":1,"maxItems":9},"contact":{"$ref":"#/components/schemas/Contact","description":"Booking contact."},"expectedTotal":{"type":"number","description":"The `offer.price.total` you agreed to (with extras), as a number. If the airline price moved, the booking is refused (PRICE_CHANGED) and nothing is booked.","exclusiveMinimum":0},"merchantReference":{"type":"string","description":"Your own reference, stored and returned with the booking.","maxLength":64,"pattern":"^[A-Za-z0-9._:-]+$"}},"required":["pricedOfferId","ticketing","travelers","contact","expectedTotal"]},"FlightBooking":{"type":"object","description":"A flight booking.","properties":{"id":{"type":"string","description":"Booking id (UUID)."},"reference":{"type":"string","description":"Booking reference (12 digits)."},"merchantReference":{"type":["string","null"],"description":"Your reference, as you sent it."},"status":{"type":"string","description":"PENDING_CONFIRMATION (the airline gave no clear answer; our team settles it), CONFIRMED (booked; not issued yet — a hold, or ticketing in progress), TICKETED, VOIDED, CANCELLED, REFUNDED, FAILED or EXCHANGED.","enum":["PENDING_PAYMENT","PENDING_CONFIRMATION","CONFIRMED","TICKETED","VOIDED","CANCELLED","REFUNDED","FAILED","EXCHANGED"]},"pnr":{"type":["string","null"],"description":"Airline booking record (PNR)."},"airlineReference":{"type":["string","null"],"description":"The airline's own record locator, when it differs."},"ticketStatus":{"type":["string","null"],"description":"NOT_TICKETED (a hold, or ticketing in progress), TICKETED, VOID_PENDING, VOIDED, REFUND_PENDING or REFUNDED.","enum":["NOT_TICKETED","TICKETED","VOID_PENDING","VOIDED","REFUND_PENDING","REFUNDED"]},"tickets":{"type":"array","description":"E-tickets.","items":{"type":"object","description":"One ticket.","properties":{"number":{"type":["string","null"],"description":"Ticket number (13 digits)."},"status":{"type":["string","null"],"description":"ISSUED, VOID, REFUNDED or EXCHANGED."},"travelerId":{"type":["string","null"],"description":"The traveller it belongs to."}},"required":["number","status","travelerId"]}},"price":{"type":"object","description":"What the booking costs.","properties":{"currency":{"type":"string","description":"ISO 4217 code."},"total":{"type":"string","description":"Booking total (paid seats included) — what issuing charges. A decimal string with 2 decimals.","pattern":"^-?\\d+\\.\\d{2}$","examples":["848.80"]},"charged":{"type":"string","description":"Charged to your wallet so far (0.00 until the ticket is issued). A decimal string with 2 decimals.","pattern":"^-?\\d+\\.\\d{2}$","examples":["848.80"]}},"required":["currency","total","charged"]},"holdReleaseAt":{"type":["string","null"],"description":"For an un-issued booking: when it is cancelled automatically unless issued (before the airline’s ticketing deadline); null otherwise.","format":"date-time"},"itineraries":{"type":"array","description":"The booked flights.","items":{"type":"object","description":"One direction of the trip (outbound, return, or one city pair of a multi-city).","properties":{"duration":{"type":["string","null"],"description":"Total duration, ISO 8601 (e.g. PT8H); null when the airline does not state it."},"segments":{"type":"array","description":"The flights, in order.","items":{"$ref":"#/components/schemas/Segment"}}},"required":["duration","segments"]}},"createdAt":{"type":"string","description":"Created.","format":"date-time"},"updatedAt":{"type":"string","description":"Last changed.","format":"date-time"}},"required":["id","reference","merchantReference","status","pnr","airlineReference","ticketStatus","tickets","price","holdReleaseAt","itineraries","createdAt","updatedAt"]},"WebhookEndpoint":{"type":"object","description":"A webhook endpoint (never its secret).","properties":{"id":{"type":"string","description":"Endpoint id."},"url":{"type":"string","description":"Where events are sent."},"status":{"type":"string","description":"ACTIVE or DISABLED.","enum":["ACTIVE","DISABLED"]},"events":{"type":"array","description":"Subscribed events (`*` = all).","items":{"type":"string","description":"Event name.","enum":["booking.created","booking.ticketed","booking.ticketing_failed","booking.ticketing_partial","booking.failed","booking.attach_failed","booking.queue_alert","booking.exchange_requested","booking.cancelled","booking.cancellation_requested","booking.voided","booking.refunded","wallet.debited","wallet.credited","wallet.reconciliation_drift","car.booking.confirmed","car.booking.cancelled","transfer.booking.confirmed","transfer.booking.cancelled","*"]}},"secretLast4":{"type":["string","null"],"description":"Last 4 characters of the signing secret, to tell secrets apart."},"createdAt":{"type":"string","description":"Created.","format":"date-time"},"updatedAt":{"type":"string","description":"Last changed.","format":"date-time"}},"required":["id","url","status","events","secretLast4","createdAt","updatedAt"]},"WebhookEndpointWithSecret":{"description":"A webhook endpoint with its signing secret — shown only in this response.","allOf":[{"$ref":"#/components/schemas/WebhookEndpoint"},{"type":"object","description":"The secret.","properties":{"secret":{"type":"string","description":"Signing secret (`whsec_…`). Store it now; it is never shown again."}},"required":["secret"]}]},"WebhookDelivery":{"type":"object","description":"One event sent (or to send) to one endpoint.","properties":{"id":{"type":"string","description":"Event id — the `Webhook-Id` header. De-duplicate on it."},"endpointId":{"type":"string","description":"Endpoint it goes to."},"event":{"type":"string","description":"Event name (e.g. booking.ticketed, webhook.test)."},"url":{"type":"string","description":"Where it was sent."},"status":{"type":"string","description":"PENDING (waiting or retrying), DELIVERED (your server answered 2xx) or FAILED (gave up after 24 hours, or a test that failed).","enum":["PENDING","DELIVERED","FAILED"]},"attempts":{"type":"integer","description":"Attempts so far."},"httpStatus":{"type":["integer","null"],"description":"Your server's last HTTP status."},"lastError":{"type":["string","null"],"description":"Last error, e.g. HTTP 500 or a timeout."},"nextAttemptAt":{"type":["string","null"],"description":"Next retry; null when no retry is planned.","format":"date-time"},"createdAt":{"type":"string","description":"Created.","format":"date-time"},"updatedAt":{"type":"string","description":"Last changed.","format":"date-time"},"payload":{"type":"object","description":"The JSON body that was signed and sent (on the single-delivery reads).","properties":{"id":{"type":"string","description":"Event id."},"event":{"type":"string","description":"Event name."},"data":{"type":"object","additionalProperties":true,"description":"Event data; depends on the event (see Webhooks → Events)."},"created_at":{"type":"string","description":"When the event happened.","format":"date-time"}}}},"required":["id","endpointId","event","url","status","attempts","httpStatus","lastError","nextAttemptAt","createdAt"]}}}}