GET /v1/flights/fares/{fareId}/booking-link
Builds the wego.com booking deep-link for a chosen Book-on-Wego fare, with its fare option pre-selected. A pure, stateless URL build from the caller-supplied search context - no upstream call, no booking, no payment. The caller passes back the trip/leg/passenger context from the flight search.
Operation ID: getFareBookingLink
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
fareId |
path | string | yes | The Book-on-Wego fare id from a flight-search trip detail. |
tripId |
query | string | yes | |
searchId |
query | string | no | |
brandedFare |
query | string | no | |
from |
query | string | yes | |
to |
query | string | yes | |
fromCity |
query | - | no | |
toCity |
query | - | no | |
fromDate |
query | string | yes | |
toDate |
query | string | no | |
cabin |
query | economy | premium_economy | business | first |
no | |
adults |
query | integer | no | |
children |
query | integer | no | |
infants |
query | integer | no | |
siteCode |
query | string | no | 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. |
currency |
query | string | no | |
locale |
query | string | no |
Responses
| Status | Description |
|---|---|
200 |
The booking handoff URL. |
400 |
Invalid fare id or query parameters. |
401 |
Missing or invalid bearer token. |
429 |
Rate limit exceeded; retry after the Retry-After seconds. |
Example
curl -s -H "Authorization: Bearer $TOKEN" \
"https://api.wego.com/v1/flights/fares/$FARE_ID/booking-link?tripId=VALUE&from=VALUE&to=VALUE&fromDate=VALUE"