The flight funnel: createFlightSearch starts an async search, getFlightSearchResults reads ranked snapshots while providers answer, getFlightTrip opens one trip with every fare. Fares with kind: "wego" continue into getFareOptions and getFareBookingLink; airline and partner fares carry their own handoff URL instead. Ids expire; a 404 means search again. getFlightSchedules sits outside the funnel – a published timetable with no prices and no search to settle.
Operations
| Verb | Operation | Carries onward |
|---|---|---|
POST |
Create a flight search · /v1/flights/searches |
searchId |
GET |
Published timetable for a route · /v1/flights/schedules |
terminal |
GET |
Read ranked flight results · /v1/flights/searches/{searchId}/results |
tripId |
GET |
Open one flight trip · /v1/flights/trips/{tripId} |
fareId |
GET |
Read a trip’s experience signals · /v1/flights/trips/{tripId}/experience |
terminal |
GET |
List a fare’s options · /v1/flights/fares/{fareId}/options |
fareOptionId |
GET |
Build a fare’s wego.com booking link · /v1/flights/fares/{fareId}/booking-link |
wego.com URL |
GET |
Build a durable wego.com search link · /v1/flights/search-link |
wego.com URL |