GET /v1.1/ship/:id

Returns a single ship by its ID, with its related company data included.

Request

GET /v1.1/ship/:id

URL Parameters

Parameter	Type	Required	Description
id	string	Yes	The ship ID

Headers

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

Example Request

curl -X GET "https://api.rccl.ro/v1.1/ship/1" \
  -H "X-WorldTravel-ApiKey: YOUR_API_KEY"

Response

200 OK

Returns a single ship resource with its related company 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/1"
  },
  "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 the related company object. See GET /v1.1/ship for company attribute details.

Error Responses

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