---
title: "Build a hotel booking link"
description: "Returns the wego.com checkout URL for a chosen rate."
---

> 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 hotel booking link

`GET /v1/hotels/{hotelId}/rates/{rateId}/booking-link`

Returns the wego.com checkout URL for a chosen rate. Pure build: no upstream call, no booking, no payment, only 400/401/429.

Operation ID: `getHotelRateBookingLink`

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `hotelId` | path | integer | yes |  |
| `rateId` | path | string | yes |  |
| `searchId` | query | string | no |  |
| `locale` | query | string | no |  |
| `guests` | query | string | no |  |
| `countryCode` | query | string | 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. |

## Responses

| Status | Description |
|---|---|
| `200` | The checkout URL. |
| `400` | Invalid request 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/hotels/$HOTEL_ID/rates/$RATE_ID/booking-link"
```

Source: https://docs.wego.com/api/hotels/get-hotel-rate-booking-link/index.mdx