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:

July 7, 2020

Updated ROOM_NO_HAIRDRYER to ROOM_NO_HAIR_DRYER.

May 22, 2020

  • Updates made to 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

Support for the No Room Size Amenity.

April 2, 2020

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

Support for Regulatory Exemption Categories under regulatoryRecords for Room type actions.

December 12, 2019

Updates made to 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

New section documenting changes between V1 and V2 was added to the documentation.

June 10, 2016

Product API v2 is now live. 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

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