AirSearch Errors

This topic provides basic discussion and a list of the error and warning messages returned by AirSearch for GDS content. Starting with AirSearch 19.6.3 and later, AirSearch enhanced error messaging to return user-friendly, standardized error and warning codes and messages. AirSearch translates the previously returned carrier or provider message into a clearer error message, and returns the carrier/provider code as well as the updated response code.

Error messaging for NDC content is separate and is discussed in NDC and GDS Content.

In this topic:

• Message Formats
• Error Messages List
• Warning Messages List
• Examples

Message Formats

AirSearch returns any error messages in either the Result/Error object for error messages or Result/Warning for warning messages.

Both types of messages return the StatusCode object (a standard HTTP response code) and a Message object with a user-friendly text message describing the error. Error messages also include a SourceCode object (a host or provider code for the same error).

AirSearch returns an error message when no offers are returned for a request. AirSearch returns a warning when a response returns offers but there is a condition the customer should know about. For example, if legSequence is not sent correctly in the AirSearch request, AirSearch ignores any cabin preference, carrier preference, and/or class of service preference sent in the request. Offers are returned, but no cabin preference, carrier preference, and/or class of service preference is applied.

Error Messages List

The following table lists the error messages and codes that AirSearch may return.

SourceCode	StatusCode (HTTP Code)	Message
9001	200	No Offers Found for channel [Identifier]
9002	200	No Offers Found for channel [Identifier]
9003	401	Access Group is not associated with the OAuth2 token.
9004	401	Invalid Access Group.
9005	500	Connection error occurred.
9006	401	Missing header XAUTH_TRAVELPORT_ACCESSGROUP.
9009	500	An error occurred accessing the Identity Manager Service.
9013	500	An error occurred. Please retry.
9015	200	No Offers Found for channel [Identifier]
9016	200	No Offers Found for catalogOfferingsId [Identifier]
9017	400	Invalid Access Group.
9018	500	NDC content is not currently available.
9019	400	Meta Search does not include NDC content.
9020	None	The legSequence at SearchCriteriaFlight and CabinPreference do not match. Cabin preference has not been applied.
9021	None	The legSequence at SearchCriteriaFlight and CarrierPreference do not match. Carrier preference has not been applied.
9022	None	The legSequence at SearchCriteriaFlight and ClassOfServicePreference do not match. Class of service preference has not been applied.
9023	400	No Offers Found for channel [Identifier]

Warning Messages List

The following table lists the warning messages and codes that AirSearch may return. Warning messages have StatusCode values of 9020, 9021, or 9022. They do not return a SourceCode object.

StatusCode	Message
9020	The legSequence at SearchCriteriaFlight and CabinPreference do not match. Cabin preference has not been applied.
9021	The legSequence at SearchCriteriaFlight and CarrierPreference do not match. Carrier preference has not been applied.
9022	The legSequence at SearchCriteriaFlight and ClassOfServicePreference do not match. Class of service preference has not been applied.

Examples

The following example is an error message that no offers were found for the specified channel identifier.

{
  "CatalogOfferingsResponse": {
    "Result": {
      "Error": [
        {
          "@type": "ErrorDetail",
          "StatusCode": "420",
          "Message": "No Offers Found for channel e5ff7545-bc34-4c71-9002-0602767e7ca4",
          "SourceCode": "9002"
        }
      ]
    }
  }
}

The next example is an error message for an authentication error.

{
  "CatalogOfferingsResponse": {
    "Result": {
      "Error": [
        {
          "@type": "ErrorDetail",
          "StatusCode": "500",
          "Message": "Invalid Access Group.",
          "SourceCode": "9004"
        }
      ]
    }
  }
}

The next example is a warning message that legSequence was not sent correctly. This message would be returned after all offers and before the ReferenceList object.

{
  "CatalogOfferingsResponse": {
    "Result": {
      "Warning": [
        {
          "@type": "Warning",
          "StatusCode": "9022",
          "Message": "The legSequence at SearchCriteriaFlight and ClassOfServicePreference do not match. Class of service preference has not been applied.",
        }
      ]
    }
}