latestOpenAPI 3.1.02026-08-21211181.8 KB

e5d7af502419

Hotels

List a hotel's rooms & rates

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.

get/v1/hotels/{hotelId}/rates

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.