Skip to main content

GET /v1.1/deck

Returns a paginated list of all ship decks, with their related ship data included.

Request

GET /v1.1/deck

Query Parameters

ParameterTypeDefaultDescription
page[number]integer1Page number (one-indexed)
page[size]integer10Items per page (max 1000)

Example Request

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

Response

200 OK

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

Response body:

{
"data": [
{
"type": "deck",
"id": "00131617-480b-368f-afd4-46922b2335a2",
"attributes": {
"code": "PH",
"title": "Puntea 06",
"number": 6,
"image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/SM-Plan-punte-6-20270430.svg",
"legend_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/Legend-CEL.png"
},
"relationships": {
"ship": {
"links": {
"related": "/v1.1/ship/4e0d4f6c-e306-36f5-a3f3-e2a7422c1c5a"
},
"data": {
"type": "ship",
"id": "4e0d4f6c-e306-36f5-a3f3-e2a7422c1c5a"
}
}
},
"links": {
"self": "/v1.1/deck/00131617-480b-368f-afd4-46922b2335a2"
}
},
{
"type": "deck",
"id": "001dccbf-46d0-3ad1-8b67-884dbf5dc10b",
"attributes": {
"code": "RS",
"title": "Puntea 12",
"number": 12,
"image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/RF-Plan-punte-12-20270430.svg",
"legend_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/Legend-CEL.png"
},
"relationships": {
"ship": {
"links": {
"related": "/v1.1/ship/3fe3de84-275c-3edc-995e-fff999764322"
},
"data": {
"type": "ship",
"id": "3fe3de84-275c-3edc-995e-fff999764322"
}
}
},
"links": {
"self": "/v1.1/deck/001dccbf-46d0-3ad1-8b67-884dbf5dc10b"
}
}
],
"links": {
"self": "/v1.1/deck",
"first": "/v1.1/deck?page[number]=1&page[size]=10",
"next": "/v1.1/deck?page[number]=2&page[size]=10"
},
"meta": {
"count": 648
},
"included": [
{
"type": "ship",
"id": "4e0d4f6c-e306-36f5-a3f3-e2a7422c1c5a",
"attributes": {
"code": "SM",
"title": "Celebrity Summit",
"description": "...",
"image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/celebrity-summit-thumb.jpg",
"hero_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/celebrity-summit-hero.jpg",
"inauguration": 2001,
"revitalization": 2019,
"capacity": 2158,
"crew": 999,
"decks": 11,
"speed": "24"
},
"relationships": {
"company": {
"links": {
"related": "/v1.1/company/43e5ba84-528c-38bc-87a9-34ece4c4aa03"
},
"data": {
"type": "company",
"id": "43e5ba84-528c-38bc-87a9-34ece4c4aa03"
}
}
},
"links": {
"self": "/v1.1/ship/4e0d4f6c-e306-36f5-a3f3-e2a7422c1c5a"
}
}
],
"jsonapi": {
"version": "1.0"
}
}

Deck Attributes

FieldTypeDescription
codestringUnique deck code
titlestringDeck name
numberintegerDeck number
image_urlstringDeck plan image URL
legend_urlstringDeck legend image URL

Relationships

RelationshipTypeDescription
shipshipThe ship this deck belongs to

Included Resources

The response includes related ship objects. See GET /v1.1/ship for ship attribute details.

Error Responses

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