Hotel Booking API

Hotel BookingAPI is the main hotel API in the Hotelbeds API ecosystem. It covers the complete booking process; it is designed to book hotels in real-time as fast as in two steps and allows to generate lists of hotels, confirm bookings, get lists of bookings, manage cancellations & modifications and obtain booking information.

Hotel Booking API works in combination with Hotel ContentAPI to obtain content information from the hotels, such as pictures, descriptions, facilities, services, etc. Please refer to the Hotel ContentAPI documentation and specification for related information.

Hotel Booking API methods

Hotel Booking API uses three different methods to manage booking functions: Hotels, CheckRates, and Bookings.

Hotel BookingAPI has been designed for a two steps confirmation, but due to the complexity of client and provider systems, a third method has been designed.


This method is used to request room availability. Some filters and special features can be applied before sending an availability request.

A flexible date search allows customers to retrieve available rates for a specified number of days prior to and post check-in.

The response generated is a list of hotels with the different room types, board types, and rates available for those hotels; but not only restricted to the dates selected.

BookingAPI prices are final. Our rates include supplements and discounts and no additional price calculations are required.

It can also return cancellation fees in the availability response, providing amounts and dates at the first step of the booking.


Most of our hotels are bookable in two steps; however, there are some of them that require obtaining up-to-date availability and prices.

These hotels have the value “recheck” in attribute rateType; and the checkrates method returns up-to-date availability and prices.

This method also returns upselling options and rates (when available). A tag displays the difference of the requested rate versus the upselling rates provided.


This method can be used for five different purposes:

  1. Confirm a booking
  2. Get a list of bookings
  3. Get the details of a particular booking
  4. Modify a booking
  5. Cancel a booking or simulate a cancelation to get the details of cancellation conditions.