GET /v1/flights/searches/{searchId}/results
Current snapshot of ranked trips (default 10, max 50 per page; out-of-range rejected 400), filters + sort applied. No completion flag: re-read (300ms→3s) until snapshotFareCount holds steady across two reads AND snapshotTripCount > 0. Each fare has a kind + handoff URL. ?view=card for lean cards.
Operation ID: getFlightSearchResults
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
searchId |
path | string | yes | |
page |
query | integer | no | Page number, 1-based (max 100). |
pageSize |
query | integer | no | Results per page (default 10, max 50); out-of-range values are rejected with 400, never clamped. |
sort |
query | score_desc | price_asc | duration_asc | leg1_departure_time_asc | leg1_departure_time_desc | leg2_departure_time_asc | leg2_departure_time_desc |
no | Sort mode; score_desc (default) ranks by the metasearch score, the leg1/leg2 modes sort by that leg’s local departure time. |
airlines |
query | string[] | no | Airline IATA codes, repeat or comma-separate (e.g. ?airlines=SQ,TR). Values are OR’d together; a trip matches if ANY leg (outbound or return) carries any listed airline, not a trip-wide AND. |
alliances |
query | string[] | no | Alliance codes, repeat or comma-separate. OR’d together; a trip matches if ANY leg (outbound or return) belongs to any listed alliance. |
stops |
query | integer[] | no | Stop counts, repeat or comma-separate (e.g. ?stops=0,1). OR’d together; matched against the trip-level stop count (the MAX across legs, i.e. the value the response’s stops field exposes), not a per-leg check, so a mixed-stop round trip (e.g. a direct outbound + a 1-stop return) is kept under ?stops=1. |
min-price |
query | number | no | Minimum cheapest-fare total price (inclusive), in the response currency. |
max-price |
query | number | no | Maximum cheapest-fare total price (inclusive), in the response currency. |
max-duration |
query | integer | no | Maximum total trip duration in minutes (inclusive). |
outbound-departure-blocks |
query | string[] | no | Coarse local-time buckets for the OUTBOUND leg’s departure ONLY (never the return leg): midnight 00:00-05:59, morning 06:00-11:59, afternoon 12:00-17:59, night 18:00-23:59, local to the departure airport. Repeat or comma-separate; OR’d together. |
outbound-departure-range |
query | - | no | Minute-of-day window min-max (each 0-1439, local to the departure airport) for the OUTBOUND leg’s departure ONLY (never the return leg). When min > max the window wraps past midnight, e.g. 1320-360 means 22:00-06:00. |
booking-types |
query | string[] | no | Booking types, repeat or comma-separate. OR’d together across the trip’s fares, a trip matches if ANY of its fares has a listed kind (partner fares never match either value). |
booking-sites |
query | string[] | no | Provider codes, repeat or comma-separate. OR’d together across the trip’s fares, a trip matches if ANY of its fares comes from a listed provider. |
stopover-airports |
query | string[] | no | Stopover airport IATA codes, repeat or comma-separate. OR’d together; a trip matches if ANY leg (outbound or return) stops over at any listed airport. |
currency |
query | string | no | |
locale |
query | string | no | |
view |
query | default | card |
no | Response projection. default = the agent trip shape (fares[] + legs; legs now carry airlinesDetail display names + per-flight segments). card = the lean UI results-list projection (cheapest-price summary + per-leg airline/aircraft/stopover, no fares[]). |
Responses
| Status | Description |
|---|---|
200 |
The current ranked-trip snapshot (agent default) or, with ?view=card, the lean list-card projection. |
400 |
Invalid request body/query/path parameters. |
401 |
Missing or invalid bearer token. |
404 |
Unknown or expired search. |
429 |
Rate limit exceeded; retry after the Retry-After seconds. |
502 |
The upstream flights service returned an invalid response. |
503 |
The flights service is temporarily unavailable; retry after the Retry-After seconds. |
Example
curl -s -H "Authorization: Bearer $TOKEN" \
"https://api.wego.com/v1/flights/searches/$SEARCH_ID/results"