Skip to main content

GET /v1.1/deck/:id

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

Request

GET /v1.1/deck/:id

URL Parameters

ParameterTypeRequiredDescription
idstringYesThe deck ID

Example Request

curl -X GET "https://api.rccl.ro/v1.1/deck/00131617-480b-368f-afd4-46922b2335a2" \
-H "X-WorldTravel-ApiKey: YOUR_API_KEY"

Response

200 OK

Returns a single deck resource with its related ship 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"
}
},
"links": {
"self": "/v1.1/deck/00131617-480b-368f-afd4-46922b2335a2"
},
"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 the related ship object. See GET /v1.1/ship for ship attribute details.

Error Responses

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