Rates & Availability API Overview

Use the Rates & Availability API to set availability, rates, and restrictions for a property's rooms on Booking.com.

Availability, Room Types, and Rates

You must specify a property's available inventory (the number of rooms or apartments of each type the property wants to sell on Booking.com) based on a room type ID. You can't specify availability at rate level, even if the room type has multiple rates. In other words, if room type 11 is available 10 times, you can't specify that it can be sold 6 times for rate 21, and 4 times for rate 22. You can only specify the total availability for room type 11 as 10.

Pricing Models

Pricing models are predefined strategies for properties to price their inventory as effectively as possible. Each pricing model has particular technical requirements that you must meet before you can support them. For more information, you can contact the Connectivity Support team.

You can set or change the pricing model for your properties on the Booking.com Connectivity Portal. Choosing which model suits a propery best could depend on which factors bring about the most profit. A property must choose one of the following three pricing models:

Specify Maximum Occupancy

For single rooms, you must only specify the Maximum Occupancy.

  • Occupancy-based Pricing (OBP)

    For each combination of room, rate, and date, you must also specify the price for each level of occupancy. This means that the room price could change depending on the number of occupants.

  • Length-of-Stay (LOS)

    In this model, you must specify a room price for the check-in date and accumulate the price for each night after that. This means that the total room price correlates to how many nights a guest booked that room.

*Derived Pricing

The Derived Pricing model is a subset of the Standard model. For each combination of room, rate, and date, you must: 1. Specify the base occupancy for a particular room rate. For example, three occupants for room rate A. 2. Specify the price for room rate A with three occupants. 3. Specify offsets for room rate A when the number of occupants changes. For example, four occupants increases the price by 25% while two decreases the price by 30%.

Availability Restrictions

You can restrict the availability of a room in the following ways:

  • Specify a minimum and/or maximum number of days a guest must book in advance.
  • Specify a minimum and/or maximum length-of-stay if a reservation includes a certain date.
  • Specify a minimum, maximum, or exact length-of-stay if a guest checks in on a certain date.
  • Make a room unavailable to book if the guest checks in and/or checks out on a certain date.
  • Make a room unavailable to book on a certain date.

To create these restrictions, you must include certain fields in your request. These fields are different for the OTA and B.XML endpoints.

You can apply restrictions to individual dates and to date ranges. Restrictions can also overlap.

Be careful with restrictions

It is possible to accidentally make a room completely unavailable by setting multiple, overlapping restrictions. The API doesn't validate this — it will not return errors or warnings if your restrictions conflict or overlap.