Error Reference Guide

Functional Errors (HTTP 200)

These errors may occur when the request can not be satisfied within the CRS due to business reasons. Reasons may include the property being temporarily inactive or there is no available inventory for the requested date of arrival. These HTTP 200 errors only return from calls made to Dcshop. They will not be seen calling DCRes. An example:

{
  "arrivalDate": "2019-12-22",
  "departureDate": "2019-12-26",
  "lengthOfStay": 735,
  "numAdults": 2,
  "propCode": "LONSB",
  "statusCode": 1740,
  "statusMessage": "REQUESTED RATE PLANS ARE NOT AVAILABLE"
}

DCShop responses that return availablity will always return statusCode=0.

Examples of HTTP200 responses that did not return availability from DCShop can return the following status codes:

HTTP 200 Codes - CRS errors

Status Message Comments
1 Reservation System error Error due to a temporary CRS system performance issue. Client is advised to retry the booking.
7 Invalid length of stay was specified
14 Invalid property code was specified
51 PRESELL 01 JAN 2020 Various temporarily inactive property errors due to reasons such as brand change / under construction, etc.
NOTE: This is an example message, the actual message will be specific to the property
52 Property Inactive
610 The data base table has too many records to support this transaction Dates searched that the CRS could not provide availability for. Most frequently occurs if searched dates are in past or father than 1 year in the future
1740 Requested Rate Plans Are Not Available

Bad Request (HTTP 400)

Swagger Error Response and Notification Definition

HTTP 400 responses can be returned due to malformed JSON requests or data that fails validation within API or CRS.

By default, the response will contain an ‘ErrorDetail’ block defining the error class and the service context that triggered the response. The ErrorDetail may include one or more ‘Notifications’ which provide additional details of the specific error type and fields affected (optional). HTTP400 error responses will include error information including the Hilton custom error code as well as associated OTA error code based on OTA 2014B ERR table. The full list of errors that are currently supported can be found in this spreadsheet. OTA Error Codes.xlsm

Swagger ErrorDetail

ErrorDetail:
    required:
      - context
      - code
      - message
    type: object
    properties:
      context:
        type: string
      code:
        type: integer
      message:
        type: string
      notifications:
        type: array
        items:
          $ref: '#/definitions/ErrorNotification'

Swagger ErrorNotification

ErrorNotification:
    required:
      - message
    type: object
    properties:
      code:
        type: string
      otaErrorCode:
        type: integer
        description: Online travel agency error code.
      fields:
        type: array
        items:
          type: string
      message:
        type: string

Error Response Example with Notification

For HTTP status code 400, an error body will be returned with the details about the errors. The body of the response will be in the following format:


Expanded details on cause of common errors that clients have reported trouble resolving.

HTTP 400 Codes - API errors

Status Message Sub Code Sub Message Comments
1001 Reservation Error 45 No travel agent address Modify request did not pass TA address thus treated as attempt to remove from reservation.
1001 Reservation Error 180 Operator ID 'xxx' is invalid at location 'TVPT' Hilton configuration error
1001 Reservation Error 234 Record not found The ID number provided is not valid or was not found in the system. This applies to any ID number, including Client ID (both Corporate & Travel Agent), Member ID (e.g., Hilton Honors Number, Travel Partner Number), etc.
1001 Reservation Error 284 There cannot be more names than max occ The number of guest names passed on the request exceed the number of people allowed in the room type NOTE: This includes additional names.
400 Reservation Error 1182 Guarantee type (Guaranteed) is not valid for this property The credit card type used is not accepted for guarantees.