Partner API Release Notes

Updated November 7th, 2022

Download the latest swagger here.

Upcoming Releases


Changes on roadmap awaiting release date

Hilton API Release v2.0.### - 13 Dec 2022

What's New?

  • TBD


Completed Releases


Hilton API Release v2.0.481 - 25 Oct 2022

What's New?

  • Added the ability to override cached config when shopping

Hilton API Release v2.0.475 - 04 Oct 2022

What's New?

  • N/A

Hilton API Release v2.0.### - 28 June 2022

What's New?

  • Added 'cxlPolicyLocalDeadline' to DcShopRatePlan and DcStayGuarantee objects.

Hilton API Release v2xxxx - 22 Feb 2022

What's New?

  • So that Hilton property front-desk agents can better handle payments a new payment type indicator (CardPaymentType) has been introduced to indicate if the payment card is credit /debit/virtual card. While this field is optional its recommended that booking requests set the payment type, especially if known to be virtual card.
  • To improve Hilton support for PSD2 and the handling of credit card payments a new Secure Customer Authentication field networkTxnRefTraceId has been added.

Hilton API Release v2.0.418- 11 Jan 2022

What's New?

  • To improve quality of guest data entering Hilton’s systems new restrictions have been added to prevent leading and trailing spaces on guest first/last name and guest address fields. To prevent any booking failure due to the restriction please ensure the spaces are removed before sending to DCRes API.
  • For use with GDS consumers the DCShop API has been upgraded to return the Hilton room type code (crsRoomTypeCode) on GDS shop responses so that they can map the codes to Hilton media/content.

Hilton API Release v2.0.392- 14 Sep 2021

What's New?

  • Updated DCShop responses to return marketing text to GDS consumers.

Hilton API Release v2.0.380- 10 Aug 2021

What's New?

  • Shop and book responses will return a new field in HTTP400 error responses indicating OTA error code.
  • To increase transparency of taxes/fees a guest will be charged additional rate information is being added to room rate details returned on shop/book responses -
  • 
    averageRate:
            description: Average rate for the stay. Calculated by dividing amountBeforeTax by length of the stay, rounded up to rate plan currency precision.
            type: number
            format: double
    averageRateAfterFees:
            description: Average rate for the stay including service charges. Calculated by dividing sum sum of amountBeforeTax and service charge by length of the stay, rounded up to rate plan currency precision.
            type: number
            format: double
    averageRateAfterTax:
            description: Average rate for the stay including taxes and service charges. Calculated by dividing amountAfterTax by length of the stay, rounded up to rate plan currency precision.
            type: number
            format: double
    amountWithFees:
            description: Amount for the stay including service charges. Calculated as sum of amountBeforeTax and service charge, rounded up to rate plan currency precision.
            type: number
            format: double
    

Hilton API Release v2.0.368- 22 Jun 2021

What's New?

  • Hilton introduced new meal code available at properties. Meal code=1 (American Breakfast). See available meal codes here.

Hilton API Release v2.0.347- 06 Apr 2021

What's New?

  • Addition of gdsChainCode returned on DCShop/DCRes responses for GDS consumers.
  • Added two new amenities to be requested on booking requests (lowFloor/nearElevator)

Hilton API Release v2.0.340- 09 Mar 2021

What's New?

  • Child-based pricing - Clients will be able to provide child ages on shop/sell requests to more accurately price at properties that have child rates. Properties have age ranges Ex: (Age 0-5=Free , Age 6-14=$35 , Age 15-17=$50). If ages are not provided on the request then Hilton CRS will default child rates to the oldest child age range. See sample code here.
  • DCRes support of PSD2 regulations – A new JSON object will be added to accept PSD2 SCA fields from clients are PSD2 enabled. Review PSD2 Support here.
  • GDS consumers of DCShop API will receive a revised sort order of products on the single property shop response - No changes necessary by GDS consumers.

Hilton API Release v2.0.329- 12 Jan 2021

What's New?

  • Made minor schema revision to DCShop and DCRes. No impact to clients.

Known Issues

  • N/A

Hilton API Release v2.0.324- 08 Dec 2020

What's New?

  • Made minor schema revision to DCShop and DCRes. No impact to clients.

Known Issues

  • N/A

Hilton API Release v2.0.313- 13 Oct 2020

What's New?

  • GDS clients have added support for inventory hold functionality with introduction of commit/release endpoints. This functionality is restricted to GDS clients only, not available to OTAs

Known Issues

  • N/A

Hilton API Release v2.0.300- 12 May 2020

What's New?

  • Made minor schema change to remove price resource as external dependency from DCShop, DCRes. No impact to clients.

Known Issues

Hilton API Release v2.0.282- 11 Feb 2020

What's New?

  • An enhancement will be made to DCShop to accept corporate client#s from certain non-OTA partners on availability requests rather than requiring rate codes.
  • DCShop and DCRes API will return meal plan code for products that include one. This will be found in the MealsIncluded object. Hilton meal plan codes noted in Code Mappings

Known Issues

  • When passing TravelPartner info on booking requests, DCRes lists ‘car’ as an option for partnerType however Hilton currently doesn’t support any car partners so this will be removed.

Hilton API Release v2.0.273- 14 Jan 2020

What's New?

Known Issues

  • Hilton’s two CRS each have different guarantee codes for same guarantee type. This has been found to cause problems with consumers so update is being made to DCRes to accept same guarantee code for both CRSs.

Hilton API Release v2.0.268- 12 Dec 2019

  • No impacts to PartnerAPIs this release

Hilton API Release v2.0.265- 12 Nov 2019

What’s New?

  • Two updates affecting GDS clients-
    • Additional client account information returned for GDS DCShop responses to indicate GDS rate plan code & category.
    • Additional Rate Plan indicator returned on DCShop responses for GDSs that note if rate plan is deposit or guarantee. This will allow for GDSs to avoid having to identify bases interpreting guarantee policy code.

Resolved Issues

Changes Needed?

  • -

Hilton API Release v2.0.261- 15 Oct 2019

What’s New?

  • -

Resolved Issues

  • Corrected issue with DCShop singleProduct shop requests made as GDS client. Previously the singleProduct response would incorrectly also return BAR rate plan when shopping a specific corporate rate.

Changes Needed?

  • -

Hilton API Release v2.0.257- 18 Sep 2019

What’s New?

  • DCShop- Added Cancel Deadline (in date/time format) as a new value returned within rate plan object. You can now use the UTC timestamp to share cancellation deadline. Previously some consumers attempted to determine deadline from the cancellation policy code.
  • DCShop- Removed extra line of abbreviated text in roomTypeDesc

Resolved Issues

  • DCShop/DCRes- Requests submitted with incorrect basic authentication credentials will now receive a HTTP401 error instead of a HTTP503 error

Changes Needed?

  • There are no breaking changes in this release! You can consume the updated APIs without making any changes.

Hilton API Release v2.0.254- 20 Aug 2019

What’s New?

  • Added additional guarantee method ‘CO’ (Guarantee to Company) as an option to be returned on DCShop responses for OTA consumers

Resolved Issues

  • Corrected issue with DCRes sell requests requiring travel agency address for PCRS brands. With fix, you shouldn’t need to pass a travel agency address on sell requests.

Changes Needed?

  • There are no breaking changes in this release! You can consume the updated APIs without making any changes.

Hilton API Release v2.0.249- 23 Jul 2019

What’s New?

  • DCShop- Added ability for GDS consumers to shop for single product
  • DCRes- Added ability for Hilton to set a default IATA for a client rather than require client to pass one in
  • DCRes- Updated swagger descriptions

Resolved Issues

  • DCRes- Corrected issue with requestCodes returning invalid values on GET response

Changes Needed?

  • There are no breaking changes in this release! You can consume the updated APIs without making any changes.