Skip to content

Rates & Availability API Overview

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

Understanding inventory vs. availability

Inventory is the total number of rooms a property offers for sale, including all room types, rate plans, restrictions, and prices.

Availability is the portion of inventory that guests can book based on their search criteria.

Example

A property has an inventory of 5 double rooms with a maximum occupancy of 3 guests, and bookable from January 1 to Jan 15.

However, this inventory is not available for guests searching for:

  • 4 guests (exceeds maximum occupancy)
  • Dates spanning January 14–16 (extends beyond booking window)

What is a pricing type?

Booking.com supports four pricing types:

  • Standard
  • Derived pricing or Rate-Level Occupancy (RLO)
  • Occupancy-Based Pricing (OBP)
  • Length Of Stay (LOS)

RLO, OBP, and LOS all support pricing per guest. Choose the type that fits the property's inventory and business needs.

Choosing a pricing type need certification from Booking.com

All pricing types need certification prior to implementing them. In addition, the Occupancy-Based Pricing (OBP) and Length Of Stay pricing (LOS) have certain technical requirements that you must meet before you can use them. For more information on how to get certified before proceeding to use these pricing types, contact the Connectivity Support team.

Pricing definitions

Standard price: The price for a room's maximum occupancy, applying to any booking with equal or fewer guests.

Base price (or Base occupancy price): A price set for a specific number of occupants, used with derived pricing (RLO).

What is pricing per guest?

Pricing per guest lets properties charge different amounts based on the number of guests. For example, a room with a maximum occupancy of 5 can offer reduced prices for fewer guests.

Derived pricing (RLO), OBP, and LOS all support this use case.

Difference between pricing types

The following table shows the pricing calculation supported by each pricing type depending on the occupancy level and length of stay.

Standard pricing
(default pricing)
Derived pricingOccupancy-based pricing (OBP)Length of stay pricing (LOS)
Supports- Pricing for maximum occupancy
- Pricing for minimum occupancy (single guest)
- Pricing for base occupancy
- Pricing offset as a percentage of base price or an absolute value depending on the number of occupants
- Pricing per occupancy- Pricing per occupancy per length of stay
Example
Stay duration: 05 days
(price calculated per night with a maximum occupancy of 4 adults)
-- $140 for 4 adults
-- $80 for 1 adult
-- $100 for 2 adults
-- (-15%) off $100 for 1 adult
-- (15) plus $100 for 3 adults
-- (25%) plus $100 for 4 adults
-- $80 for 1 adult
-- $100 for 2 adults
-- $120 for 3 adults
-- $140 for 4 adults
-- $80 per night for 1 adult for 01 - 05 days
-- $100 per night for 2 adults for 01 - 05 days
-- $120 per night for 3 adults for 01 - 05 days
-- $140 per night for 4 adults for 01 - 05 days
Stay duration: 10 days
(price calculated per night with a maximum occupancy of 4 adults)
Same price per nightSame price per nightSame price per night-- $70 per night for 1 adult for 06 - 10 days
-- $90 per night for 2 adults for 06 - 10 days
-- $110 per night for 3 adults for 06 - 10 days
-- $130 per night for 4 adults for 06 - 10 days
Stay duration: 15 days
(price calculated per night with a maximum occupancy of 4 adults)
Same price per nightSame price per nightSame price per night-- $60 per night for 1 adult for 11 - 15 days
-- $80 per night for 2 adults for 11 - 15 days
-- $90 per night for 3 adults for 11 - 15 days
-- $120 per night for 4 adults for 11 - 15 days

For more information on each of the pricing types, see:

Pricing type supported features

The following table lists all the benefits of choosing a pricing type and how they compare with each other.

BenefitsStandard pricingDerived pricingOccupancy-based pricing (OBP)Length of stay pricing (LOS)
Supports single occupancy pricingYes, fixed priceYes, pricing offsets per occupancy levelYes, fixed price per occupancy levelYes, fixed price per occupancy level per length of stay
Supports base or maximum occupancy pricingYes, fixed priceYes, fixed priceYes, fixed price per occupancy levelYes, fixed price per occupancy level per length of stay
Supports pricing per guestsNoYes, pricing offsets per occupancy levelYes, fixed price per occupancy levelYes, fixed price per occupancy level per length of stay
Supports pricing per guest per length of stayNoNoNoYes
Needs Booking.com certificationNoNoYesYes

Going live

Before you go live with your API integration, you'll need to meet certain requirements. For more information, see Going Live.