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

Example Request

curl -X GET "https://api.rccl.ro/v1.1/ship/e182ebbc-166d-3336-ae79-86813a7fc5f1" \
  -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": "e182ebbc-166d-3336-ae79-86813a7fc5f1",
        "attributes": {
            "code": "AD",
            "title": "Adventure of the Seas",
            "description": "Este timpul sa va intoarceti la aventura...",
            "image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/2019/03/Croaziera_Adventure_of_the_Seas_Thumb.jpg",
            "hero_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/adventure-of-the-seas-thumb.jpg",
            "inauguration": 2001,
            "revitalization": 2016,
            "capacity": 3114,
            "crew": 1185,
            "decks": 15,
            "speed": "22"
        },
        "relationships": {
            "company": {
                "links": {
                    "related": "/v1.1/company/2a15e462-7710-332a-b536-2ef4731d9dad"
                },
                "data": {
                    "type": "company",
                    "id": "2a15e462-7710-332a-b536-2ef4731d9dad"
                }
            }
        },
        "links": {
            "self": "/v1.1/ship/e182ebbc-166d-3336-ae79-86813a7fc5f1"
        }
    },
    "links": {
        "self": "/v1.1/ship/e182ebbc-166d-3336-ae79-86813a7fc5f1"
    },
    "included": [
        {
            "type": "company",
            "id": "2a15e462-7710-332a-b536-2ef4731d9dad",
            "attributes": {
                "code": "RCC",
                "title": "Royal Caribbean International®",
                "description": "Royal Caribbean International® este cea mai inovatoare companie de croaziere din grupul RCCL...",
                "hero_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/Croaziera_Harmony_of_the_Seas_Hero-1.jpg",
                "logo_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/royal_logo-2.png",
                "site_url": "https://rccl.ro/branduri-croaziera/royal-caribbean-international",
                "terms_of_service_url": "https://rccl.ro/termeni-si-conditii-de-rezervare-croaziere-royal-caribbean-international",
                "non_refundability_terms_url": "https://rccl.ro/tarife-cu-depozit-nerambursabil-royal-caribbean-international",
                "gratuities_included": false,
                "dining_description": "Masa de seara (cina) se serveste in restaurantul principal...",
                "dining_image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/CEL_PR_JUN02_ENHANCED-CONCIERGE-80-opacity.jpg",
                "gratuity_description": "Pe toate vasele, se obişnuieste sa se ofere o taxa pentru serviciile la bordul vasului...",
                "gratuity_image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/CEL-BY-guest-service-il-cel-01.jpg",
                "deck_legend_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/legenda-plan-punti-Royal.png"
            },
            "links": {
                "self": "/v1.1/company/2a15e462-7710-332a-b536-2ef4731d9dad"
            }
        }
    ],
    "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