Hotels

Create a hotel search

Changed on Aug 25, 2026

Creates a Book-on-Wego hotel search (city, single hotel, or geo point) and returns its opaque searchId plus the occupancy priced upstream (resolved child ages, incl. the age-8 fallback when none supplied). Poll /results for ranked hotels. A hotelId search is the only one getHotelRates accepts.

post/v1/hotels/searches

Request

Base URL
https://api.wego.com
Auth
- OAuth 2
  Authorization codehttps://auth.wego.com/user-auth/v2/users/oauth/authorize
  Token URLhttps://auth.wego.com/user-auth/v2/users/oauth/token
- or HTTP bearer
TypeScript
https://skmtc.dev/wego/apis/wego-api/docs/v1/hotels/searches/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

Example request

{
  "cityCode": "DXB"
}

Response

Search created.

searchIdstring required

Opaque id for the created search.

siteCodestring required

The site code (Wego market) the search was created for.

siteCodeSource'explicit' | 'default' required

How the API resolved siteCode: explicit (caller-supplied – including a market a client derived and passed) or default (US, no site supplied).

Changes

Aug 25, 202610fbc4e6f532 Revision changes
- warning
  added the new rates_require_hotel_search enum value to the response property for the response status
- warning
  added the new rates_require_hotel_search enum value to the response property for the response status
- warning
  added the new rates_require_hotel_search enum value to the response property for the response status
- warning
  added the new rates_require_hotel_search enum value to the response property for the response status
- warning
  added the new rates_require_hotel_search enum value to the response property for the response status
- warning
  added the new rates_require_hotel_search enum value to the response property for the response status

Operation history