Product API
ReferenceProduct API

Revision history

Product API online documentation will only be maintained for the latest available version. When a new version is published, the documentation will only reflect the latest version of the API.

Additionally, older versions will be kept for six months at most after the release of a new version, to give you time to migrate. Anyone using older versions will be notified when versions are slated for retirement and be given time to migrate over.

The following updates have been made to the Product API, from newest to oldest updates:

January 2023

Added new error code 3027 to ensure strict Per Person fees validation for a same age category in a given duration.

November 2021

Added new error codes 3083 and 3089 to ensure strict Cancelation Penalty validations in RatePlan level.

November 2021

Allowed amenity PUT, amenity GET, and rateThresholds endpoints to receive and return v3 amenity content type.

October 2021

Maximum number of cancellation policy exceptions was reduced from 200 to 50.

September 2021

Maximum number of cancellation policy exceptions was reduced from 500 to 200.

February 8, 2021

Updated support of custom cancellation policy.

December 10, 2020

Updated Eligibility for Hotel Loyalty Points value addition to Eligible for Hotel Loyalty Points.

November 9, 2020
  • Added Wholesale Rate Plan to the list of Rate Plan types. Wholesale Rate Plan to be supported only during the GET and not during PUT,POST,PATCH or DELETE. The error code list is updated with 3232 error code which is returned when Create, Update or Delete of Wholesale Rate Plan is attempted.
  • Updated the Contact us link to direct additional questions.
  • Updated additionalGuestAmount resource to include missing percent.
October 30, 2020

Added fitness codes for Room Amenity:

July 7, 2020


May 22, 2020
  • Updated the ROOM_COFFEE_TEA and ROOM_ELECTRONIC_DEVICE amenity codes to not support detailed codes anymore. Alternatively, each detail code has now been spun up as a different Amenity Code. Here are the new amenity codes: ROOM_COFFEE_AND_TEA_MAKER, ROOM_ESPRESSO_MAKER, ROOM_ELECTRIC_KETTLE, ROOM_COMPUTER, ROOM_TABLET, ROOM_IPAD.
  • Updated Expedia's requirements to certify Product API. Refer to the JSON Reference topic for more information.
April 29, 2020

Added support for the No Room Size Amenity.

April 2, 2020

Added support for 100+ new amenities spread across all categories: Internet access, Bathroom, Food-related, In-room entertainment, Bedding and linens, Room layout, In-room service, Room features, and Club/executive level. Added a new category for accessibility amenities inside guest accommodations.

February 14, 2020

Added support for Regulatory Exemption Categories under regulatoryRecords for Room type actions.

December 12, 2019

Updated Room type resource management to the V3 version, which includes bedroom and living room details. V2 versions moved over to the Archived section.

June 7, 2019

Released new feature to expose <allowedAgeCategories> for Property level GET. Added documentation references in Sample Messages and Reference.

June 15, 2018

Added support documentation about Per Stay Service Fees at the Rate plan level (GET, POST, PUT).

August 7, 2017
  • Added information about managing deposit required flag in conjunction with Deposit API.
  • Added documentation about new <depositPolicy> link in Rate Plan's links section of the response payload on GET Rate Plan and GET Rate Plans operations.
July 31,2017

Added access to room type and rate plan resources without "/products" in endpoint path.

May 19, 2017

Corrected list of support room views.

November 12, 2016

Released new feature to expose a rate plan's deposit required flag, create, and last update dates in read-only format. These attributes can be read via GET. They cannot be provided with a create request (deposit is set to false by default), and they cannot be changed in update requests.

October 20, 2016

Released a new feature to expose a room type's rate thresholds, in read-only format. Only GET operation is allowed on this sub resource.

October 18, 2016

Released a new feature to expose RatePlanLinkage information in read-only format in rate plan GET. Added a links section to the show rate plan resource's link to itself, its rate plan linkage parent, if any, and/or its derived child rate plans, if any.

September 29, 2016

Added new section documenting changes between V1 and V2 to the documentation.

June 10, 2016

Released Product API v2. Versioning strategy changed from URL to using content-type and accept headers. As a result, URLs have all changed to have V1 removed when you are ready to use V2. Room type resource changed significantly for defining bed types and occupancy.

May 2, 2016

Added support for cancel policy exceptions.

April 27, 2016

Added support for Rate Plan Delete.

April 4, 2016

Refreshed list of supported value adds, added more pricing models supported, clarified required VS optional fields.

February 1, 2016

Added support for room-level amenities (GET and PUT).

January 7, 2016

Support for read/create/update room views and wheelchair accessibility in room type resource.

December 7, 2015

Released the first version of the API. Additional feature since last PDF version: support for read/create/update room size in room type resource.