Booking Workflow

HotelGo Stays API provides a single API to search, book and manage accommodation bookings across our supplier network.

Our booking flow consists of four key steps to successfully create a booking:

Retrieve all rooms and details for a hotel

1. Search for Stays `HotelList`

Powering discovery is the first step in every great booking experience.
Use our HotelList endpoint to search a list of hotels for given dates and number of guests.
In return, you will only receive available properties that match your search criteria.

It’s expected that a search result’s may not include all rooms and rates information, but you will always recieve the cheapest starting price per result.

2. Retrieve all available room rates for your chosen result `HotelRates`

Search for a desired result from the previous step by using the HotelRates endpoint to retrieve all available rooms and rates for that result.
A single hotel provides multiple room types, and each room type can have several packages. The price of a package is determined by its inclusions and policies. For instance, the same room can be sold at different price points depending on whether it's non-refundable, includes breakfast, or is fully flexible.
To proceed, you must capture the RatePkgId of the exact package your user selects. This ID is the key to rechecking final availability and creating the final booking.

3. Perform Final availability and price recheck `CheckAvail`

The hotel market is dynamic—prices and availability can change in an instant. The CheckAvail endpoint is your most important tool for guaranteeing a seamless booking experience and preventing failed transactions.
By calling this endpoint right before creating the booking, you perform one final, real-time check to confirm the offer is still valid.

4. Create a booking `Book`

The Book endpoint requests a booking confirmation for the specified package (RatePkgId). When successful, the endpoint will return all the information related to your booking.
If you'd like to get a complete look at data you can provide when creating an order and what you'll get back, check out our API Reference

Booking flow

Booking Workflow#

1. Search for Stays HotelList#

2. Retrieve all available room rates for your chosen result HotelRates#

3. Perform Final availability and price recheck CheckAvail#

4. Create a booking Book#

Booking Workflow

1. Search for Stays `HotelList`

2. Retrieve all available room rates for your chosen result `HotelRates`

3. Perform Final availability and price recheck `CheckAvail`

4. Create a booking `Book`