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:
November 2024
"Full Kitchen" has been deprecated as a value-add for standalone and corporate rate plans (in favor of relying only on room amenities to indicate kitchens).
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:
- These do not require detail codes: ROOM_TREADMILL, ROOM_STATIONARY_BIKE, ROOM_ROWING_MACHINE, ROOM_ELLIPTICAL_MACHINE
- Use IN_ROOM or ON_REQUEST detail codes : ROOM_FREE_WEIGHTS, ROOM_STREAMING_FITNESS_CLASSES, ROOM_WORKOUT_APPAREL, ROOM_OTHER_WORKOUT_EQUIPMENT
July 7, 2020
Updated ROOM_NO_HAIRDRYER to ROOM_NO_HAIR_DRYER.
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.