Sign in
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. searchId must name a hotel-scoped search (one created with hotelId); a city or geo search is a 409.

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.

Changes

Changed in 3 of the 8 revisions of this API.63

  • 10fbc4e6f53261See the full diff
    • ●

      added the new rates_require_hotel_search enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new rates_require_hotel_search enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new rates_require_hotel_search enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new rates_require_hotel_search enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new rates_require_hotel_search enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new rates_require_hotel_search enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

  • b655bb3704c21See the full diff
    • ○

      added the optional property /// to the response with the status

      response-optional-property-added

  • 0c80b58717391See the full diff
    • ○

      added the required property to the response with the status

      response-required-property-added