Cruises

Get cruise lines and ships

GET/v1/return_cruises

Returns available cruise lines with their ships and sailing dates.

Code Examples

curl

curl -H "access-token: {{token}}" \
  "https://apistage.projectexpedition.com/v1/return_cruises"

JavaScript

const response = await fetch('https://apistage.projectexpedition.com/v1/return_cruises', {
  headers: {
    'access-token': 'YOUR_TOKEN'
  }
});

const data = await response.json();

PHP

<?php
$context = stream_context_create([
    'http' => [
        'method' => 'GET',
        'header' => "access-token: YOUR_TOKEN"
    ]
]);

$response = file_get_contents('https://apistage.projectexpedition.com/v1/return_cruises', false, $context);
$data = json_decode($response, true);

Responses

200 List of cruises

[
  {
    "cruiseline": "Royal Caribbean",
    "cruiseship": "Anthem of the Seas",
    "sailing_dates": [
      "2025-06-15",
      "2025-06-22",
      "2025-06-29"
    ]
  },
  {
    "cruiseline": "Royal Caribbean",
    "cruiseship": "Explorer of the Seas",
    "sailing_dates": [
      "2025-07-01",
      "2025-07-08"
    ]
  },
  {
    "cruiseline": "Celebrity Cruises",
    "cruiseship": "Celebrity Eclipse",
    "sailing_dates": [
      "2025-06-20",
      "2025-07-04"
    ]
  }
]

---

Get cruise itinerary destinations

GET/v1/return_cruise_destinations

Returns port destinations for a specific cruise sailing.

Parameters

Parameter	Type	Required	Description
cruiseline	string	Required	Cruise line name
cruiseship	string	Required	Cruise ship name
sailing_date	string (date)	Required	Sailing date (YYYY-MM-DD)

Code Examples

curl

curl -H "access-token: {{token}}" \
  "https://apistage.projectexpedition.com/v1/return_cruise_destinations?cruiseline=Royal%20Caribbean&cruiseship=Anthem%20of%20the%20Seas&sailing_date=2025-06-15"

JavaScript

const response = await fetch('https://apistage.projectexpedition.com/v1/return_cruise_destinations?cruiseline=Royal%20Caribbean&cruiseship=Anthem%20of%20the%20Seas&sailing_date=2025-06-15', {
  headers: {
    'access-token': 'YOUR_TOKEN'
  }
});

const data = await response.json();

PHP

<?php
$context = stream_context_create([
    'http' => [
        'method' => 'GET',
        'header' => "access-token: YOUR_TOKEN"
    ]
]);

$response = file_get_contents('https://apistage.projectexpedition.com/v1/return_cruise_destinations?cruiseline=Royal%20Caribbean&cruiseship=Anthem%20of%20the%20Seas&sailing_date=2025-06-15', false, $context);
$data = json_decode($response, true);

Responses

200 Cruise destinations with arrival/departure times

[
  {
    "towns": [
      {
        "id": 123,
        "name": "Dublin",
        "slug": "dublin",
        "arrive_date": "2025-06-16",
        "arrive_time": "08:00",
        "depart_date": "2025-06-16",
        "depart_time": "18:00"
      },
      {
        "id": 125,
        "name": "Cork",
        "slug": "cork",
        "arrive_date": "2025-06-17",
        "arrive_time": "07:00",
        "depart_date": "2025-06-17",
        "depart_time": "17:00"
      }
    ]
  }
]

400 Missing parameters or cruise not found

---