This API serves as a mediator for accessing data from external cruise APIs, providing a unified and simplified interface for developers to access data from multiple cruise APIs.

The main purpose of this API is to provide developers with a standardized and efficient way to access cruise-related data from various cruise lines, such as ship details, cabin availability, and pricing information. This allows developers to build applications that can compare prices, find available cabins, and make bookings across different cruise lines, without having to integrate with each cruise line's API separately.

The API offers a range of parameters that can be customized to suit the needs of each use case, including filters for searching cruises, sorting options, and pagination. It also provides real-time updates for availability and pricing information, enabling developers to build dynamic and responsive applications.

Overall, the purpose of the Traveltek GraphQL API is to provide a comprehensive and streamlined solution for accessing and integrating with multiple cruise line APIs, simplifying the development process and enhancing the user experience for consumers seeking to book cruises.

Hello and thank you for using the CruiseConnect API in BETA. Your feedback is vital to help us address and improve the API's stability. We appreciate your patience as we work towards delivering a seamless and reliable experience. You can fork / view / import a copy of the collection using the Run in Postman button below.

The Cruise Connect API (jarvis.cruiseconnect.traveltek.net/graphql) requires authorization & id tokens which can be retrieved from the auth.cruiseconnect.traveltek.net/tokens endpoint. The auth endpoint accepts your API username & password as a JSON object in the body of the POST request and returns a JSON object with your access & id tokens. These tokens are currently valid for 1 hour, after which you will need to call the auth endpoint again.

Request examples:

Here are cURL examples of requests to obtain the access/id tokens and then make a request to the GraphQL api with the tokens in the headers

Get Tokens

Request:

curl --location 'https://auth.cruiseconnect.traveltek.net/tokens' \
--header 'Content-Type: application/json' \
--data '{
    "username": "string",
    "password": "string"
}'

Response:

{
    "authorization_token": "Bearer eyJraWQiOi...Hno1iJVKbc",
    "id_token": "raWQiOiJmN...jWU9nAO4ns"
}

Make GraphQL request

Request:

curl --location --request POST 'https://jarvis.cruiseconnect.traveltek.net/graphql' \
    --header 'tokens: {"authorization_token":"eyJraWQiOi...Hno1iJVKbc","id_token":"raWQiOiJmN...jWU9nAO4ns"}' \
    --header 'Content-Type: application/json' \
    --data-raw '{"query":"query MyQuery {\n  cruises(supplierCode: \"CCL\", destination: "Miami", embarkEarliestDate: \"2024-08-09\") {\n    searchResults {\n      duration\n      id\n    }\n  }\n}\n      ","variables":{}}'

This cURL example demonstrates how to make a POST request to the GraphQL API using cURL.

To send the equivalent request body with a GraphQL type, use the following query:

query MyQuery {
    cruises(
            supplierCode: "CCL", 
            destination: "Miami",
            embarkEarliestDate: "2024-08-09"
        ) {
        searchResults {
            duration
            id
        }
    }
}

Response:

{
"data": {
    "cruises": {
        "searchResults": [
            {
                "duration": 3,
                "id": "20240809CQ03"
            },
            {
                "duration": 8,
                "id": "20240810CB08"
            },
            .
            .
            .
            {
                "duration": 5,
                "id": "20240810SN05"
            }
        ]
    }
}

}

---

Traveltek API is powered by GraphQL. GraphQL is a query language for APIs that allows clients to specify exactly the data they wish to retrieve from the server.

To learn more about GraphQL language and its concepts, see the official GraphQL website.

To make a request to the GraphQL API, send a POST request to the /graphql/ endpoint with the GraphQL query as the body. Use the HTTP POST method and set the Content-Type header to application/json. See the Authentication section on how to obtain the Tokens which are required to be passed in the headers.

Here's an example query to fetch the product name of all cruises embarking from port named "Southampton":

{
    cruises(
        embarkPort: "Southampton"
    ) {
        searchResults {
            product {
                name
            }
        }
    }
}

Response:

{
    "data": {
        "cruises": {
            "searchResults": [
                {
                    "product": {
                        "name": "11 Nights Repositions - Other"
                    }
                },
                {
                    "product": {
                        "name": "NORTHERN EUROPE, 7 nights"
                    }
                }
            ]
        }
    }
}

---

This guide describes how to search for cruises from the Traveltek GraphQL API.

To search for cruises, you need to run the cruises query. Let's take a look at an example query to fetch a list of cruises (embarking from Southampton from 1st January 2025 onwards):

{
    cruises(
        embarkPort: "Southampton"
        embarkEarliestDate: "2025-01-01"
    ) {
        searchResults {
        product {
            name
        }
        duration
        }
    }
}

Response:

{
    "data": {
        "cruises": {
            "searchResults": [
                {
                    "product": {
                        "name": "NORTHERN EUROPE, 7 nights"
                    },
                    "duration": 7
                },
                {
                    "product": {
                        "name": "NORTHERN EUROPE, 7 nights"
                    },
                    "duration": 7
                }
            ]
        }
    }
}

In this example, for each CruiseSearchResult, we want to return the following fields:

• product name: The name of the cruise product
• duration: The number of nights that will be spent on the cruise

The cruises query only provides summary lead in prices (cheapest available) for the 4 cabin types (Inside, Outside, Balcony and Suite) of a cruise. //It doesn't provide any cabin availability information. To obtain this availability and more detailed pricing information for an individual cruise you need to run the cruise query.

The cruises query currently only returns search results however we will be opening up the ability to retrieve live pricing & cabin availability via the cruise query - check back here in the future for more information.

---

The Traveltek GraphQL API functions as a mediator and often sends multiple requests to external cruise APIs.

Therefore, the response time for a request consists of the response times from the Cruise APIs as well as the Traveltek overhead, which may result in variable response times depending on the cruiselines.

Despite our continuous efforts to decrease overhead latency, the Traveltek API has a default timeout of 30 seconds for each request.

Moreover, the Traveltek GraphQL API provides various parameters that can be customized to meet the speed and content requirements of each user's case.