GET /v1.1/ship

Returns a paginated list of all ships, with their related company data included.

Request

GET /v1.1/ship

Headers

Header	Required	Description
X-WorldTravel-ApiKey	Yes	API key for authentication

Query Parameters

Parameter	Type	Default	Description
page[number]	integer	1	Page number (one-indexed)
page[size]	integer	10	Items per page (max 1000)

Example Request

curl -X GET "https://api.rccl.ro/v1.1/ship?page[number]=1&page[size]=10" \
  -H "X-WorldTravel-ApiKey: YOUR_API_KEY"

Response

200 OK

Returns an array of ship resources with related company objects included.

Response body:

{
  "data": [
    {
      "type": "ship",
      "id": "1",
      "attributes": {
        "code": "AL",
        "title": "Allure of the Seas",
        "description": "One of the world's largest cruise ships",
        "image_url": "https://example.com/images/allure-thumb.jpg",
        "hero_url": "https://example.com/images/allure-hero.jpg",
        "inauguration": 2010,
        "revitalization": 2020,
        "capacity": 5400,
        "crew": 2200,
        "decks": 16,
        "speed": "22 knots"
      },
      "relationships": {
        "company": {
          "links": {
            "related": "/v1.1/company/1"
          },
          "data": {
            "type": "company",
            "id": "1"
          }
        }
      },
      "links": {
        "self": "/v1.1/ship/1"
      }
    }
  ],
  "links": {
    "self": "/v1.1/ship",
    "first": "/v1.1/ship?page[number]=1&page[size]=10",
    "next": "/v1.1/ship?page[number]=2&page[size]=10"
  },
  "meta": {
    "count": 25
  },
  "included": [
    {
      "type": "company",
      "id": "1",
      "attributes": {
        "code": "RCI",
        "title": "Royal Caribbean International",
        "description": "Global cruise line",
        "hero_url": "https://example.com/images/rci-hero.jpg",
        "logo_url": "https://example.com/images/rci-logo.png",
        "site_url": "https://www.royalcaribbean.com",
        "terms_of_service_url": "https://example.com/terms",
        "non_refundability_terms_url": "https://example.com/refund-terms",
        "gratuities_included": true,
        "dining_description": "Complimentary dining in the main restaurant",
        "dining_image_url": "https://example.com/images/dining.jpg",
        "gratuity_description": "Gratuities are included in the fare",
        "gratuity_image_url": "https://example.com/images/gratuity.jpg",
        "deck_legend_url": "https://example.com/images/deck-legend.png"
      },
      "links": {
        "self": "/v1.1/company/1"
      }
    }
  ],
  "jsonapi": {
    "version": "1.0"
  }
}

Ship Attributes

Field	Type	Description
code	string	Unique ship code
title	string	Ship name
description	string	Ship description
image_url	string	Thumbnail image URL
hero_url	string	Hero/banner image URL
inauguration	integer	Year the ship was inaugurated
revitalization	integer	Year of last revitalization
capacity	integer	Maximum passenger capacity
crew	integer	Number of crew members
decks	integer	Number of decks
speed	string	Maximum speed

Relationships

Relationship	Type	Description
company	company	The cruise line operating this ship

Included Resources

The response includes related company objects. See the company attributes:

Field	Type	Description
code	string	Company code
title	string	Company name
description	string	Company description
hero_url	string	Hero image URL
logo_url	string	Logo image URL
site_url	string	Company website URL
terms_of_service_url	string	Terms of service URL
non_refundability_terms_url	string	Non-refundability terms URL
gratuities_included	boolean	Whether gratuities are included in fares
dining_description	string	Dining information
dining_image_url	string	Dining image URL
gratuity_description	string	Gratuity policy description
gratuity_image_url	string	Gratuity image URL
deck_legend_url	string	Deck legend image URL

Error Responses

Status	Description
401	Unauthorized — missing or invalid API key
500	Internal Server Error — upstream query failure