---
title: "Build a hotel booking link"
method: GET
path: "/v1/hotels/{hotelId}/rates/{rateId}/booking-link"
tags: ["Hotels"]
---

# 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.

## Path parameters

- `hotelId` integer, required
- `rateId` string, required

## Query parameters

- `searchId` string
- `locale` string
- `guests` string
- `countryCode` string
- `siteCode` string

## Response `200`

The checkout URL, and the fact that it expires.

- object
  - `bookingUrl` string, required — The wego.com hotel checkout URL for the rate.
  - `expires` true, required — Always true: this link is search-scoped and stops working when the rate's search expires. A stale link loads an empty checkout page rather than erroring, so treat it as short-lived and re-price the rate to get a fresh one.

## Other responses

- `400` — Invalid request parameters.
- `401` — Missing or invalid bearer token.
- `429` — Rate limit exceeded; retry after the `Retry-After` seconds.

---

[API](https://skmtc.net/wego/apis/wego-api.md) · [All operations](https://skmtc.net/wego/apis/wego-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wego/wego-api/revisions/e5d7af502419/schema)