We will up-version our APIs when:

  • we change the format of the response data for one or more calls
  • we change the response type (i.e. changing an integer to a float)
  • we remove any part of the API.

We will NOT up-version for non-breaking changes such as:

  • adding new response fields
  • adding new endpoints/operations
  • adding new optional paramethers in the requests
  • changing the order of properties in existing API responses.
  • changing the length or format of strings.

Upcoming changes

We will be releasing BookingAPI v2.0 next year.

Stay tunned to know the incoming changes in advance and be prepared!


This is the list of changes BookingAPI had so far:


  • Availability: added inclusions for resident rates.


  • BookingCancellation, BookingBookingDetail, BookingChange: changed HTTP error code when a booking is not found or the user does not have permissions from 400(Bad request) code to 404(Not Found).
  • BookingCancellation: changed HTTP error code when trying to cancel an already cancelled booking from 400(Bad request) code to 409(Conflict).


  • Booking: added price tolerance on request.


  • BookingList: added extended booking information parameter.


  • BookingList: "from" and "to" limit increased from 100 to 1000 of results per response.


  • BookingList: filter by cancellation policies.


  • Booking: Invoice Company field added to response.


  • New allotment control: error returned when clients request more allotment than the available one.


  • BookingChange: operation now available.
  • BookingList: New parameters by which to filter - clientReference, hotels, destinations.


  • Booking: compressed response when the request has Accept-Encoding header.


  • BookingList: Filter by agencyReference, hotelCode, destination, country...


  • Availability: number of rooms that can be requested increased from 5 to 10.


  • BookingList: "from" and "to" limit increased from 25 to 100 bookings.
  • Changed several INVALID errors that were incorrectly being returned with the 500 error code to 400.
  • Changed PRODUCT_EXCEPTION errors from 500 to 503 error code.

Docs Navigation