Hotels

List a hotel's rooms & rates

Changed on Aug 25, 2026

Returns the Book-on-Wego rooms & rates for a hotel (cheapest-first): room name, board, refundability, price, and each rate's composed booking reference id. searchId must name a hotel-scoped search (one created with hotelId); a city or geo search is a 409.

get/v1/hotels/{hotelId}/rates

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/:hotelId/rates/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

hotelIdinteger required

The hotel's numeric id (a positive integer), as carried by hotel search results (results[].hotelId) and embedded in a rate id.

Query parameters

searchIdstring required

The search the hotel was found in (from createHotelSearch); rates are priced within that search context. Required.

currencystring

Pricing currency as a 3-letter ISO 4217 code (e.g. AED). Defaults to USD.

localestring

Response language tag (e.g. en, ar). Defaults to en.

Response

Cheapest-first Book-on-Wego rates.

hotelIdnumber required

The hotel these rates are for.

searchIdstring required

The search these rates were priced within.

currencyCodestring required

The currency every rate price on this read was computed in – the same value as metadata.currencyCode, which carries currencyCodeSource beside it. Read it before you show a number: a price computed in the wrong currency renders as a perfectly normal price.

searchCompleteboolean required

Advisory: true means upstream reports it finished aggregating rates for this search. It is not a guarantee that the list on this page is final, so do not block on it.

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
- info
  added the non-success response with the status
Aug 20, 2026b655bb3704c2 Revision changes
- info
  added the optional property /// to the response with the status

Operation history (3 revisions)