Skip to main content
This changelog tracks public-facing changes to the Best Price API: new endpoints, breaking changes, deprecation notices, and behaviour adjustments worth knowing about.
​
Reference

​
Several restriction strategies in one call

Rates, Rooms, and Hotels (Arrivals) accept a behaviours array:
  • With a single strategy, the response keeps its shape: one entry per rate, room, or hotel, with its best price over the period and the arrival date it applies to.
  • List one or more of LowestLengthOfStay, CheapestStay, and EarliestAvailability. Each rate, room, or hotel is then returned once per strategy, with the new behaviour response field telling you which one it was computed for. An empty list falls back to behaviour, then to LowestLengthOfStay. Send a single value in most cases, and list several only to replace separate calls: each extra strategy affects performance.
  • The single behaviour request property is deprecated on these three endpoints and can’t be combined with a non-empty behaviours. Calendar keeps its single behaviour.
  • Rates and Rooms entries return availability: the number of rooms still available for the room and rate over the returned stay.
  • filter.maximumStay now accepts values from 1 to 31 on Calendar, Rates, Rooms, and Hotels (Arrivals).
​
Reference

​
Every field of the five endpoints

The five Reference pages describe every request and response field, with example values throughout:
  • Impersonation: which fields each token scope requires, and when a call returns a 403.
  • Calendar takes exactly one party in guests. The array is kept for forward compatibility, and a request with more than one party returns a 400.
​
New use case

​
Multi-currency price display use case

A new use case shows how to display prices in the guest’s currency when the property sells in another one: one call in the property’s currency, a public daily exchange rate feed, and a conversion at display time. See Multi-currency price display.
​
Taxes and fees

​
Taxes and fees on every endpoint

All five Best Price endpoints now return four optional fields alongside each best price: additionalTaxes and additionalFees for amounts collected on top of totalPrice (at booking or on site), and includedTaxes and includedFees for amounts already part of totalPrice.
​
Public release

​
Initial public documentation

Five Best Price endpoints are publicly documented:
  • Calendar: best price per arrival date for a single hotel.
  • Rates: best price per rate plan for a single hotel.
  • Rooms: best price per room type for a single hotel.
  • Hotels (Arrivals): best price per hotel across multiple properties.
  • Hotels (Stays): best price across hotels for a specific stay.