Hotel Release Notes

Below are the releases of the Travelport JSON Hotel APIs prior to v11.

All versions of the Hotel APIs prior to v11 will be deprecated and no longer supported as of 4 Sep 2022. See Schema Retirement for more information. See the Hotel v11 Release Notes for the latest updates.

Hotel Search

22.11.1: Model upgrade | 24 Mar 2022

Updates to model version 11. See the Hotel v11 Release Notes for updates.

All previous versions of the Hotel Search API have been deprecated.

Supplier identification for lowest rate | 24 Jun 2021

Adds a new field to each property in all Hotel Search responses identifying which supplier system returned the lowest available rate for that property.

Search by hotel chain and name | 28 Jan 2021

Adds the ability to search by hotel chain and name.

Search by airport code | 10 Sep 2020

Search updated to model 10v10. Search by location request and response now includes IATA airport or city code option.

Hotel Details

22.11.1: Model upgrade, search by hotel chain and name | 24 Mar 2022

Updates to model version 11. See the Hotel v11 Release Notes for updates.

All previous versions of the Hotel Details API have been deprecated.

Hotel Availability

Supplier identification for lowest rate | 24 Jun 2021

Adds a new object (Identifier.value) to each room rate in Hotel Availability responses defining which supplier system returned that rate for that property.

Additional search options | April 2021

Adds the following:

  • Search for more rooms: Provides ability for user to request rates for multiple rooms at a single property.

  • Separate room and rate description: Provides better differentiation of the rate description and room description for each rate returned in an availability response.

Improved error messages | 24 Sep 2020

Enhanced Hotel Availability error messages to better determine the cause of any failure.

Model 10 update; rate payment details | 13 Aug 2020

Updates Hotel Availability to model X v10. Updates the request and response with new attributes in the RateCandidatesDetail request, and corresponding RatePaymentInfo in the response Terms and Conditions.

Tax and fee details in Availability response | 23 Jul 2020

Updates the Hotel Availability response to provide structured tax and fee details and a breakdown.

All Hotel APIs

This section lists releases affecting all hotel APIs.

Model updates | Jan 2020

Updates all Hotel APIs to a version of ODM Model X as follows:

  • Updates Hotel Search, Details, Availability, Rules to model X v8
  • Updates Hotel Create Reservation, Add Reservation, Modify Reservation, and Cancel Reservation to model X v7

The following changes apply across the model X updates:

  • A new endpoint is provided for every API. See the individual topics for each endpoint.
  • The pagination feature is not supported at this time. Future releases may return support for pagination.
  • The NextSteps object, which provided the request for the next step in the workflow, is no longer returned in any response that previously returned it.
  • In Hotel Search and Hotel Rules, support for requesting conversion rate information from the source currency to a requested target currency. The conversion rate returned can be used to calculate conversion amounts independently.
  • Most APIs have a number of changes to their response structure. See individual topics for the new response structure.

The high-level changes for individual Hotel APIs are:.

  • Hotel Search:
    • The addition of a POST request to support a message request payload that includes a list of up to 50 property IDs to search. The GET request for searches by either geographic coordinates or city remains supported.
  • Hotel Rules:
    • The HTTP request has changed from a GET to a POST. Request query parameters have been replaced with a message request payload.
  • Hotel Availability version X v8 updates include significant changes to the request and response. Notably, in the request:
    • The Hotel Availability GET request is no longer supported, only the POST request.
    • The number of properties that can be requested has changed from 25 to 10.
    • Each ratePlanCode must be sent with an associated chain and property code.