v3.2 v3.3
Learn how the Demand API represents accommodation discounts, bundles and inventory rates, and find guidance for retrieving and displaying them.
The rates and discounts returned by the Demand API can depend on the stay dates, the traveller’s location and platform, their user groups, and your partner configuration.
Bundles describe benefits included with an accommodation product.

The Demand API supports several discount mechanisms. Each type has a distinct business purpose and API behaviour.
- Deals — Promotional discounts, which can be tied to campaigns or time periods.
- Target rates — Rates for eligible travellers, for example based on their platform or location.
- Closed user group (CUG) rates — Rates available to eligible travellers in a defined user group.
Discount information is returned in the products.deal object. The information you can retrieve depends on your partner configuration.
See Displaying discounts for guidance on presenting discount information to travellers.
The Demand API can return different types of discounts for different purposes:
- Promoting time-sensitive campaigns, such as Black Friday or flash deals.
- Highlighting products during specific promotional periods.
- Offering discounts based on when a traveller searches or books.
- Driving short-term bookings through targeted promotions.
Examples of deals available through the Demand API include:
| Deal | Description |
| Logged-in | Available to eligible authenticated travellers. Previously referred to as Secret deals. |
| Limited-time | A promotional discount with time-sensitive eligibility. |
| Black Friday | A promotional discount associated with the Black Friday campaign. |
| Early year | A promotional discount associated with an early-year campaign. |
| Flash | A promotional discount associated with a flash campaign. |
| Getaway | A promotional discount associated with a getaway campaign. |
| Late escape | A promotional discount associated with a late-escape campaign. |
See the Deal tags for the complete list of tags returned by each API version.
Target rates are rates offered to travellers who meet specific criteria, such as their booking platform or location.
You can use target rates to:
- Offer mobile-specific prices;
- Target travellers in specific countries or regions;
- Support market-specific pricing strategies.
Target rate types include:
| Mobile rates - Rates available to eligible travellers booking through a mobile platform. | Geo/country rates - Rates available based on the traveller's country. |
Closed user group (CUG) rates are rates available only to eligible members of a defined user group.
For example, CUG rates can be used to provide eligible authenticated travellers with Genius or other membership-based rates.
To retrieve CUG rates:
- The traveller must meet the requirements of the applicable user group;
- You must provide the appropriate
booker.user_groupsvalues in the request; - Your partner account must have access to the applicable rates.
CUG rates can also be combined with other discounts when rate stacking is enabled for your account.
Access to CUG rates depends on your partner configuration. Contact your Account Manager for details.
A bundle combines an accommodation product with one or more benefits defined by the accommodation, such as free parking or internet access.
Bundle information is descriptive: the API returns the bundle with the product, and its benefits are reflected in the product’s price and policies.
See Bundles and value adds to understand how bundles are represented, and Retrieve and display bundles and value adds for implementation guidance.
The Demand API provides access to Booking.com inventory rates and, for eligible integrations, third-party inventory (TPI) rates.
Accommodation order details can include inventory information that identifies the inventory classification, including Booking.com Sell_* and Net_* rates.
See Booking.com inventory rates for guidance on interpreting this information in pre-booking and post-booking responses.
Third-party inventory (TPI) rates are sourced from external suppliers and can supplement Booking.com inventory with additional availability and pricing.
See the Third-party inventory section to learn how to retrieve and book TPI rates.
- Learn how to display discounts in your application.
- Explore Demand API deals, target and CUG rates.
- See Bundles and value adds to understand how bundles are represented.
- Learn how to retrieve and book Third-party inventory rates.