POST /v1.1/search/dining
Search for available dining sittings for a specific sailing and stateroom subcategory. Returns dining options including traditional fixed-time sittings and flexible open dining.
Request
POST /v1.1/search/dining
Request Body
{
"departure": {
"date": "20261205"
},
"itinerary": {
"code": "07D519",
"ship": {
"code": "RH"
}
},
"guests": {
"adults": 2,
"children": 0
},
"stateroom_subcategory": {
"code": "4B"
},
"promotion": {
"code": "BESTRATE"
}
}
Body Parameters
| Field | Type | Required | Description |
|---|---|---|---|
departure.date | string | Yes | Departure date (YYYYMMDD format) |
itinerary.code | string | Yes | Itinerary code |
itinerary.ship.code | string | Yes | Ship code |
guests.adults | integer | Yes | Number of adult guests |
guests.children | integer | Yes | Number of child guests |
stateroom_subcategory.code | string | Yes | Stateroom subcategory code |
promotion.code | string | No | Promotion code (e.g. BESTRATE) |
Example Request
curl -X POST "https://api.rccl.ro/v1.1/search/dining" \
-H "X-WorldTravel-ApiKey: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"departure": { "date": "20261205" },
"itinerary": { "code": "07D519", "ship": { "code": "RH" } },
"guests": { "adults": 2, "children": 0 },
"stateroom_subcategory": { "code": "4B" },
"promotion": { "code": "BESTRATE" }
}'
Response
200 OK
Returns an array of sitting resources with related objects included.
Response body:
{
"data": [
{
"type": "sitting",
"id": "01106da4-2c48-3d09-8b54-78e3a406610b",
"attributes": {
"departure": "2026-12-05",
"type": "Traditional",
"description": "05:30 PM",
"open": true,
"family_time": true,
"smoking_allowed": false
},
"relationships": {
"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_subcategory": {
"links": {
"related": "/v1.1/stateroom_subcategory/55523f76-70a2-3ea9-8e77-e68cb819c503"
},
"data": {
"type": "stateroom_subcategory",
"id": "55523f76-70a2-3ea9-8e77-e68cb819c503"
}
},
"sitting_category": {
"links": {
"related": "/v1.1/sitting_category/69691c7b-dcc3-3e6d-9d8a-1361f22d04ac"
},
"data": {
"type": "sitting_category",
"id": "69691c7b-dcc3-3e6d-9d8a-1361f22d04ac"
}
}
},
"links": {
"self": "/v1.1/sitting/01106da4-2c48-3d09-8b54-78e3a406610b"
}
},
{
"type": "sitting",
"id": "e43137e9-8d35-3593-8bbe-379fd333e18f",
"attributes": {
"departure": "2026-12-05",
"type": "Traditional",
"description": "09:00 PM",
"open": true,
"family_time": false,
"smoking_allowed": false
},
"relationships": {
"company": {
"data": {
"type": "company",
"id": "2a15e462-7710-332a-b536-2ef4731d9dad"
}
},
"ship": {
"data": {
"type": "ship",
"id": "9508a19d-7801-307e-a7b7-628c31bfdd47"
}
},
"stateroom_subcategory": {
"data": {
"type": "stateroom_subcategory",
"id": "55523f76-70a2-3ea9-8e77-e68cb819c503"
}
},
"sitting_category": {
"links": {
"related": "/v1.1/sitting_category/eccbc87e-4b5c-32fe-a830-8fd9f2a7baf3"
},
"data": {
"type": "sitting_category",
"id": "eccbc87e-4b5c-32fe-a830-8fd9f2a7baf3"
}
}
},
"links": {
"self": "/v1.1/sitting/e43137e9-8d35-3593-8bbe-379fd333e18f"
}
},
{
"type": "sitting",
"id": "d5c13514-b2f6-33e4-97bf-cfdc10b1ab34",
"attributes": {
"departure": "2026-12-05",
"type": "Open",
"description": "MY TIME",
"open": true,
"family_time": false,
"smoking_allowed": false
},
"relationships": {
"company": {
"data": {
"type": "company",
"id": "2a15e462-7710-332a-b536-2ef4731d9dad"
}
},
"ship": {
"data": {
"type": "ship",
"id": "9508a19d-7801-307e-a7b7-628c31bfdd47"
}
},
"stateroom_subcategory": {
"data": {
"type": "stateroom_subcategory",
"id": "55523f76-70a2-3ea9-8e77-e68cb819c503"
}
},
"sitting_category": {
"links": {
"related": "/v1.1/sitting_category/f1862177-53c3-3b9b-9f95-8d906208506e"
},
"data": {
"type": "sitting_category",
"id": "f1862177-53c3-3b9b-9f95-8d906208506e"
}
}
},
"links": {
"self": "/v1.1/sitting/d5c13514-b2f6-33e4-97bf-cfdc10b1ab34"
}
}
],
"meta": {
"count": 3
},
"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": "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"
}
},
{
"type": "sitting_category",
"id": "69691c7b-dcc3-3e6d-9d8a-1361f22d04ac",
"attributes": {
"code": "M"
},
"links": {
"self": "/v1.1/sitting_category/69691c7b-dcc3-3e6d-9d8a-1361f22d04ac"
}
},
{
"type": "sitting_category",
"id": "eccbc87e-4b5c-32fe-a830-8fd9f2a7baf3",
"attributes": {
"code": "3"
},
"links": {
"self": "/v1.1/sitting_category/eccbc87e-4b5c-32fe-a830-8fd9f2a7baf3"
}
},
{
"type": "sitting_category",
"id": "f1862177-53c3-3b9b-9f95-8d906208506e",
"attributes": {
"code": "O"
},
"links": {
"self": "/v1.1/sitting_category/f1862177-53c3-3b9b-9f95-8d906208506e"
}
}
],
"jsonapi": {
"version": "1.0"
}
}
Sitting Attributes
| Field | Type | Description |
|---|---|---|
departure | string | Departure date (ISO 8601) |
type | string | Dining type (Traditional for fixed-time, Open for flexible) |
description | string | Time slot (e.g. 05:30 PM) or dining program name (e.g. MY TIME) |
open | boolean | Whether this sitting is currently available for booking |
family_time | boolean | Whether this is a family-friendly time slot |
smoking_allowed | boolean | Whether smoking is allowed |
Relationships
| Relationship | Type | Cardinality | Description |
|---|---|---|---|
company | company | one | Operating cruise line |
ship | ship | one | The ship |
stateroom_subcategory | stateroom_subcategory | one | The stateroom subcategory |
sitting_category | sitting_category | one | The sitting category code |
Included Resource Types
| Type | Description |
|---|---|
ship | Ship details |
company | Cruise line details |
stateroom_subcategory | Subcategory details (color, surface area, image) |
facility | Facility/amenity group |
sitting_category | Sitting category code |
Error Responses
| Status | Description |
|---|---|
401 | Unauthorized — missing or invalid API key |
500 | Internal Server Error — upstream query failure |