---
title: "Build a durable wego.com hotel search link"
method: GET
path: "/v1/hotels/search-link"
tags: ["Hotels"]
---

# Build a durable wego.com hotel search link

`GET /v1/hotels/search-link`

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

## Query parameters

- `cityCode` string, required
- `checkIn` string, required
- `checkOut` string, required
- `adults` integer
- `children` integer
- `childrenAges` string
- `rooms` integer
- `currency` string
- `locale` string
- `siteCode` string

## Response `200`

The durable wego.com hotel-search URL.

- object — The durable wego.com hotel-search URL.
  - `searchUrl` string, required — A wego.com hotel-search URL for this city, dates and occupancy. Opening it runs the search live.
  - `expires` false, 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.

## Other responses

- `400` — Invalid query parameters. checkIn must be a real calendar date and not in the past; checkOut must be after it; rooms is 1-4 and cannot be more than adults; childrenAges is required when children is above 0 and must have exactly that many entries.
- `401` — Missing or invalid bearer token.
- `429` — Rate limit exceeded; retry after the `Retry-After` seconds.

## Changes

- **2026-08-25** `10fbc4e6f532` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/wego/apis/wego-api/changes/v1/hotels/search-link/get.md)

---

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