Cruise Offers API

The Cruise Offers API provides real-time pricing and availability for TUI cruise packages to third-party agents. Consumers can search for a destination through the TUI API gateway and receive current cruise offers.

NOTE: TUI Marella & River Cruises are both currently supported by the cruiseOffers API.

API Endpoints

API Methods

Method: GET

{
  "cruiseOffersRequest": {
      "xmlns": "http://tuiuk.com/xsd/cruise/cruiseoffers/v1",
      "cruiseType": "Fly Cruise",
      "maxResultCount": "2",
      "departureAirportCode": "LGW",
      "destination": [{
          "countryCode": "BRB"
      }, {
          "countryName": "Barbados"
      }, {
          "regionCode": "L04304"
      }, {
          "regionName": "Caribbean"
      }, {
          "itineraryCode": "440505"
      }, {
          "itineraryName": "A Taste of Paradise"
      }, {
          "shipCode": "055414"
      }, {
          "shipName": "Marella Celebration"
      }, {
          "portOfCall": "St John's"
      }],
      "isFlexible": "true",
      "departureMonth": 01,
      "departureYear": 2021,
      "duration": {
          "numOfDays": 7
      },
      "numOfAdults": 1,
      "numOfChildren": 2,
      "childAgeOnReturn": ["11", "13"],
      "sellingMarketCode": "UK"
  }
}

HTTP Headers

Search Input Parameters

Search parameters should be submitted in the same order and are case sensitive.

Response Parameters

Every response includes a standard HTTP status code. A successful request returns 200 OK; failed requests return an appropriate 4xx or 5xx code together with the error structure described below.

Error Message Structure

In addition to the standard HTTP response code, failed API calls contain error information in the message body. Gateway errors generally relate to access control or an invalid API key, while API-generated errors describe invalid request content or downstream processing failures. Cruise Offers API error codes range from E001 to E999.

Below is the list of errors currently available in API. Kindly note this is not a definitive list as we may add the additional conditions based on the requirement. Hence, please use them for reference.

Warning Message Structure

In addition to errors, the API may return warnings. These provide supplementary information and may indicate that the search criteria should be refined or that the returned result has a minor data gap. Cruise Offers API warning codes range from W001 to W999.

Below is the list of warnings currently available in API. Kindly note this is not a definitive list as we may add the additional conditions based on the requirement. Hence, please use them for reference.

Support

For support, contact TIBCO Operations Support.