Overview

With the Get Room Rates API, you can retrieve the list of rooms for a specific hotel, along with their rates, from multiple suppliers.

To ensure best performance and flexibility, we have designed the following two-step Get Room Rates API workflow:

  1. Initiate Room Rates Search API allows you to initiate the room rates request.

  2. Get Room Rates Results API allows you to retrieve the list of rooms for a specific hotel, along with their rates, from multiple suppliers.

Note: For a seamless experience, we have provided two use cases for you to try out, namely a per-booking pricing model use case and a per-room pricing model use case. You must verify the pricing model that is returned in the response of the Get Room Rates Results API, and then call the appropriate pricing model call in the Rate Rules, and Book APIs. For example, if the response from the Get Room Rates Results API call returns a per booking pricing model from the supplier, you must call the Get Rate Rules - Per Booking use case, Book - Per Booking use case, and then the Cancel - Per Booking use case.

The following table lists the base URL and endpoints for the Get Room Rates API endpoints:

APIMethodBase URLEndpoint
Initiate Room Rates SearchPOSThttps://usg.cnxloyalty.com/api/hotels/getroomrates/{sessionId}/init
/api/hotels/getroomrates/init
(stand-alone room rates search)
Get Room Rates ResultsGEThttps://usg.cnxloyalty.com/api/hotels/getroomrates/{sessionId}/{hotelId}/results

Initiate Room Rates Search

This API initiates the room rates request. You can initiate a stand-alone room rates request or initiate a room rates search for a hotel that was retrieved in an earlier hotel search call.

This API returns the sessionId in the response, which you can use to retrieve results at any point in time.

Initiate a Room Rates Search for a Hotel that was Retrieved in an Earlier Hotel Search Call

This API allows you to get the the room rates for a hotel that was retrieved in an earlier Hotel Search call. After you perform a hotel search, you might want to get the room rates for a specific hotel to display the list of available rooms or to proceed further in the shopping workflow.

Initiate a Stand-Alone Room Rates Search

By using this API, you can directly retrieve the list of rooms that are available for a specific hotel, along with their rates, from multiple suppliers. You can also request for the room rates from specific suppliers, if required.

Consider a scenario where an OTA is promoting a specific hotel from a preferred supplier. The OTA has a banner on the home page that lets their users know about a promotional offer of 25% off on bookings for that specific hotel. In this scenario, when the user clicks on the banner, the OTA might want to directly get the room rates for that specific hotel, from multiple suppliers, and display the list of available rooms on the page. The Get Room Rates API allows you to take care of such scenarios with minimal time and effort. Instead of having to have various calls, you can directly call the Get Rooms Rates API and proceed from there.

Get Room Rates Results

This API returns the rooms rates from multiple suppliers, for the given hotel for the given guest count (occupants), and the duration of stay (check-in and check-out dates).

Note: For a seamless experience, we have provided two use cases for you to try out, namely a per booking pricing model use case and a per room pricing model use case. You must verify the pricing model that is returned in the response of the Get Room Rates Results API, and then use the appropriate pricing model call in the Rate Rules, and Book APIs. For example, if the response from the Get Room Rates Results API call returns a per booking pricing model from the supplier, you must use the Get Rate Rules - Per Booking use case, Book - Per Booking use case, and then the Cancel - Per Booking use case.

<< Go to the previous API: Search API     |      Go to the next API: Get Rate Rules API >>

For any query or suggestions, feel free to drop an email to support@one-connect.io