latestOpenAPI 3.1.02026-08-21211181.8 KB

e5d7af502419

Flights

Build a durable wego.com search link

Builds a shareable wego.com flight-search URL from the caller's own route, dates, cabin and passengers. A pure, stateless string build - no upstream call, no search created. It carries no search-scoped id, so it does not expire: whoever opens it runs the search live.

get/v1/flights/search-link

Query parameters

fromstring required
Example:DXB

Origin airport or city code, as sent to the flight search.

tostring required
Example:LHR

Destination airport or city code, as sent to the flight search.

boolean
OR
'0' | '1' | 'true' | 'false'

Whether from is a city code rather than an airport code.

boolean
OR
'0' | '1' | 'true' | 'false'

Whether to is a city code rather than an airport code.

fromDatestring required

Outbound departure date, YYYY-MM-DD, as sent to the flight search.

toDatestring

Return date, YYYY-MM-DD. Omit for a one-way handoff.

cabin'economy' | 'premium_economy' | 'business' | 'first'

Cabin class, as sent to the flight search.

adultsinteger

Adult passengers (1-9).

childreninteger

Child passengers (0-8).

infantsinteger

Infant passengers (0-8). Must not exceed adults.

siteCodestring

Wego market (point of sale) as a 2-letter code, e.g. AE. Optional: if omitted the API defaults to US. A client that knows the user's market (the wego CLI derives it from the id_token) passes it as an explicit siteCode.

currencystring
Example:AED

Pricing currency as a 3-letter ISO 4217 code (e.g. AED). Optional: when omitted the built URL carries NO currency parameter – it is not defaulted to USD, so wego.com shows the market's own default. Pass it to pin the handoff to a currency.

localestring
Example:en

Response language tag for the wego.com page (e.g. en, ar). Defaults to en.

Response

The durable wego.com search URL.

searchUrlstring required

A wego.com flight-search URL for this route, dates, cabin and passengers. Opening it runs the search live.

expiresfalse required

Always false: the URL carries no search-scoped id, so it keeps working. The prices behind it are whatever a live search returns when it is opened.