Guides · Concepts
Shopping vs Orders
Shopping finds and prices offers; orders are bookings. Everything else follows from this split.
D-212Offers and orders
Shopping
Stateless · Produces offers
Nothing is reserved. Offers expire within minutes.
Orders
Stateful · Produces bookings
Held at the airline: booked, paid, ticketed, changed.
Shopping
A search returns offers: an itinerary and a price the airline will sell for a limited time. Nothing is held.
Each offer carries
- baggage_included and ancillaries_included — the fare's bags and extras, with bag weight and size limits.
- expires_at — after it, search again.
- fare_family and fare_rules — the branded fare and its change and refund rules.
- offer_id — what you price and book with.
- slices[] and their segments[] — the itinerary.
- total_amount and currency — for all passengers; passengers[] breaks it down.
Shopping endpoints
POST /v1/shopping/offers · POST /v1/offers/price · GET /v1/offers/{offerID}/seats · GET /v1/offers/{offerID}/services
Orders
An order is the booking at the airline, made from a priced offer and passengers, with or without payment. See the Payment Flow and Orders Lifecycle guides.
Order lifecycle
| State | Meaning |
|---|---|
| pending | Transitional, before the airline confirms the booking. |
| confirmed | Booked at the airline. An unpaid hold stays here until expires_at, then is cancelled. |
| ticketed | Tickets issued. |
| partially_cancelled | Some flights cancelled; the rest stands. |
| disrupted | The airline changed or cancelled a flight; read the order. |
| cancelled | Closed at the airline. |
| refunded | Refund recorded; the airline returns it to the card that paid. |
| failed | The booking or its payment did not complete. |
Order endpoints
POST /v1/orders · GET /v1/orders/{orderID} · POST /v1/orders/{orderID}/commit · POST /v1/orders/{orderID}/change · POST /v1/orders/{orderID}/cancel
The bridge: OfferPrice
Send the search's offer_id to POST /v1/offers/price. The airline confirms the current price and returns a new offer_id, valid until price_guaranteed_until. Book with that id; a search id or a lapsed priced offer is refused.
AirShopping
→ OfferPrice
→ OrderCreate
→ Order confirmed