GET /v1.1/ship
Returns a paginated list of all ships, with their related company data included.
Request
GET /v1.1/ship
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": "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"
}
},
{
"type": "ship",
"id": "e892e780-304d-33ef-95e6-9b9f3fed3669",
"attributes": {
"code": "AL",
"title": "Allure of the Seas",
"description": "Cand vine vorba de vacante epice...",
"image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/RCI-AL-allure-of-the-seas-amplified-thumb-1080x1080-toolkit-rci01.jpg",
"hero_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/2019/03/Croaziera_Allure_of_the_Seas_Hero.jpg",
"inauguration": 2010,
"revitalization": 2025,
"capacity": 5484,
"crew": 2100,
"decks": 18,
"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/e892e780-304d-33ef-95e6-9b9f3fed3669"
}
}
],
"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": 58
},
"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 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 |