GET /v1.1/stateroom/:id
Returns a single stateroom (cabin) by its ID, with related subcategory, deck, positioning, bed, company, ship, and attribute data included.
Request
GET /v1.1/stateroom/:id
URL Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The stateroom ID |
Example Request
curl -X GET "https://api.rccl.ro/v1.1/stateroom/113b8879-e07e-30b3-8c0f-f28605cf1ba4" \
-H "X-WorldTravel-ApiKey: YOUR_API_KEY"
Response
200 OK
Returns a single stateroom resource with related objects included.
Response body:
{
"data": {
"type": "stateroom",
"id": "113b8879-e07e-30b3-8c0f-f28605cf1ba4",
"attributes": {
"code": "7014",
"connecting": false,
"capacity": 2,
"window": true,
"window_size": "31X79",
"furniture": "The color scheme for the cabin is: PASTL. The cabin contains following furniture items: PRIVATE VERANDA, SITTING AREA W/SOFA BED, DRY REFRIGERATOR, WALL TO WALL CARPETING, SAFE, LOW TABLE, BEAUTY TABLE, 2 NIGHT TABLES, CHAIR",
"baby_bed": true,
"balcony": true,
"television": true,
"beds": 2,
"upper_beds": 0,
"telephone": true,
"obstructed_view": false,
"accessible": false,
"area": 18
},
"relationships": {
"stateroom_subcategory": {
"links": {
"related": "/v1.1/stateroom_subcategory/55523f76-70a2-3ea9-8e77-e68cb819c503"
},
"data": {
"type": "stateroom_subcategory",
"id": "55523f76-70a2-3ea9-8e77-e68cb819c503"
}
},
"deck": {
"links": {
"related": "/v1.1/deck/74462101-b07b-37a3-9727-40b23fad29a9"
},
"data": {
"type": "deck",
"id": "74462101-b07b-37a3-9727-40b23fad29a9"
}
},
"stateroom_positioning": {
"links": {
"related": "/v1.1/stateroom_positioning/3529ede4-5dae-3c71-81e9-3eef3ffc0638"
},
"data": {
"type": "stateroom_positioning",
"id": "3529ede4-5dae-3c71-81e9-3eef3ffc0638"
}
},
"bed": {
"data": [
{
"type": "bed",
"id": "4754db57-69c9-3799-aef0-49f3e46ab107"
}
]
},
"company": {
"links": {
"related": "/v1.1/company/2a15e462-7710-332a-b536-2ef4731d9dad"
},
"data": {
"type": "company",
"id": "2a15e462-7710-332a-b536-2ef4731d9dad"
}
},
"ship": {
"links": {
"related": "/v1.1/ship/9508a19d-7801-307e-a7b7-628c31bfdd47"
},
"data": {
"type": "ship",
"id": "9508a19d-7801-307e-a7b7-628c31bfdd47"
}
},
"stateroom_attribute": {
"data": [
{
"type": "stateroom_attribute",
"id": "994c9e5d-c26d-36b0-a78e-7fee711689c1"
},
{
"type": "stateroom_attribute",
"id": "abcc9496-66ea-3004-912d-e4316f35b27d"
}
]
}
},
"links": {
"self": "/v1.1/stateroom/113b8879-e07e-30b3-8c0f-f28605cf1ba4"
}
},
"links": {
"self": "/v1.1/stateroom/113b8879-e07e-30b3-8c0f-f28605cf1ba4"
},
"included": [
{
"type": "ship",
"id": "9508a19d-7801-307e-a7b7-628c31bfdd47",
"attributes": {
"code": "RH",
"title": "Rhapsody of the Seas",
"description": "..."
},
"links": {
"self": "/v1.1/ship/9508a19d-7801-307e-a7b7-628c31bfdd47"
}
},
{
"type": "company",
"id": "2a15e462-7710-332a-b536-2ef4731d9dad",
"attributes": {
"code": "RCC",
"title": "Royal Caribbean International\u00ae",
"description": "..."
},
"links": {
"self": "/v1.1/company/2a15e462-7710-332a-b536-2ef4731d9dad"
}
},
{
"type": "deck",
"id": "74462101-b07b-37a3-9727-40b23fad29a9",
"attributes": {
"code": "CM",
"title": "Puntea 07",
"number": 7,
"image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/RH-Plan-punte-7-20240413.svg",
"legend_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/Legend-RCC.png"
},
"links": {
"self": "/v1.1/deck/74462101-b07b-37a3-9727-40b23fad29a9"
}
},
{
"type": "stateroom_attribute",
"id": "994c9e5d-c26d-36b0-a78e-7fee711689c1",
"attributes": {
"code": "CONV",
"description": "PAT CONVERTIBIL"
},
"links": {
"self": "/v1.1/stateroom_attribute/994c9e5d-c26d-36b0-a78e-7fee711689c1"
}
},
{
"type": "bed",
"id": "4754db57-69c9-3799-aef0-49f3e46ab107",
"attributes": {
"code": "2C",
"description": "2 PATURI CONVERTIBILE IN PAT QUEEN SIZE"
},
"links": {
"self": "/v1.1/bed/4754db57-69c9-3799-aef0-49f3e46ab107"
}
},
{
"type": "stateroom_positioning",
"id": "3529ede4-5dae-3c71-81e9-3eef3ffc0638",
"attributes": {
"code": "FW",
"title": "In fata vasului",
"image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/Vas_croaziera_fata-1.png"
},
"links": {
"self": "/v1.1/stateroom_positioning/3529ede4-5dae-3c71-81e9-3eef3ffc0638"
}
},
{
"type": "stateroom_subcategory",
"id": "55523f76-70a2-3ea9-8e77-e68cb819c503",
"attributes": {
"code": "4B",
"color": "94D0E8",
"title": "Cabina spatioasa cu balcon cu vedere la ocean",
"description": "...",
"surface_area": 18,
"balcony_area": 3,
"image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/2019/03/RH_Cabina_4B.jpg"
},
"links": {
"self": "/v1.1/stateroom_subcategory/55523f76-70a2-3ea9-8e77-e68cb819c503"
}
},
{
"type": "facility",
"id": "d4dd111a-4fd9-3339-8238-aca5c05bebe3",
"attributes": {
"title": "ROYAL CARIBBEAN INTERNATIONAL - CABINE",
"description": "..."
},
"links": {
"self": "/v1.1/facility/d4dd111a-4fd9-3339-8238-aca5c05bebe3"
}
}
],
"jsonapi": {
"version": "1.0"
}
}
Stateroom Attributes
| Field | Type | Description |
|---|---|---|
code | string | Cabin number |
connecting | boolean | Whether the cabin connects to an adjacent cabin |
capacity | integer | Maximum guest capacity |
window | boolean | Whether the cabin has a window |
window_size | string | Window dimensions |
furniture | string | Furniture and cabin description |
baby_bed | boolean | Whether a baby bed is available |
balcony | boolean | Whether the cabin has a balcony |
television | boolean | Whether the cabin has a television |
beds | integer | Number of beds |
upper_beds | integer | Number of upper (pullman) beds |
telephone | boolean | Whether the cabin has a telephone |
obstructed_view | boolean | Whether the view is obstructed |
accessible | boolean | Whether the cabin is wheelchair accessible |
area | number | Cabin area in m² |
Relationships
| Relationship | Type | Cardinality | Description |
|---|---|---|---|
stateroom_subcategory | stateroom_subcategory | one | The subcategory this cabin belongs to |
deck | deck | one | The deck the cabin is on |
stateroom_positioning | stateroom_positioning | one | Position on the ship (forward, midship, aft) |
bed | bed | many | Bed type configurations |
company | company | one | Operating cruise line |
ship | ship | one | The ship |
stateroom_attribute | stateroom_attribute | many | Cabin attributes (e.g. convertible bed, crib) |
Included Resource Types
| Type | Description |
|---|---|
ship | Ship details |
company | Cruise line details |
deck | Deck number, name, deck plan image and legend |
stateroom_attribute | Cabin feature attributes |
bed | Bed type configuration |
stateroom_positioning | Ship position with diagram image |
stateroom_subcategory | Subcategory details (color, surface area, image) |
facility | Facility/amenity group |
shower | Shower type |
Error Responses
| Status | Description |
|---|---|
401 | Unauthorized — missing or invalid API key |
500 | Internal Server Error — stateroom not found or upstream query failure |