---
title: "Build a fare's wego.com booking link"
description: "Builds the wego.com booking deep-link for a chosen Book-on-Wego fare, with its fare option pre-selected."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.wego.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Build a fare's wego.com booking link

`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

```bash
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"
```

Source: https://docs.wego.com/api/flights/get-fare-booking-link/index.mdx