POST /v1.1/search/categories
Search for stateroom category fares for a specific sailing. Returns pricing per stateroom category with optional subcategory-level fare breakdowns and cabin availability.
Request
POST /v1.1/search/categories
Request Body
{
"departure": {
"date": "2026-12-05"
},
"itinerary": {
"code": "07D519",
"ship": {
"code": "RH"
}
},
"guests": {
"adults": 2,
"children": 0
},
"promotion": {
"code": "BESTRATE"
}
}
Body Parameters
| Field | Type | Required | Description |
|---|---|---|---|
departure.date | string | Yes | Departure date (YYYY-MM-DD 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 |
promotion.code | string | No | Promotion code (e.g. BESTRATE) |
Example Request
curl -X POST "https://api.rccl.ro/v1.1/search/categories" \
-H "X-WorldTravel-ApiKey: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"departure": { "date": "2026-12-05" },
"itinerary": { "code": "07D519", "ship": { "code": "RH" } },
"guests": { "adults": 2, "children": 0 },
"promotion": { "code": "BESTRATE" }
}'
Response
200 OK
Returns an array of stateroom category fare resources with related objects included.
Response body:
{
"data": [
{
"type": "stateroom_category_fare",
"id": "adb042b2-8648-36b8-8d66-ee5a0a11b035",
"attributes": {
"departure": "2026-12-05",
"amount": 571,
"savings_amount": 656
},
"relationships": {
"stateroom_category": {
"links": {
"related": "/v1.1/stateroom_category/c45045e7-ade7-37c9-b259-a3fbc39e66e8"
},
"data": {
"type": "stateroom_category",
"id": "c45045e7-ade7-37c9-b259-a3fbc39e66e8"
}
},
"value_add": {
"links": {
"related": "/v1.1/value_add/d6ec61d6-70c4-319d-9f58-342f0ae63785"
},
"data": {
"type": "value_add",
"id": "d6ec61d6-70c4-319d-9f58-342f0ae63785"
}
},
"stateroom_subcategory_fare": {
"data": [
{
"type": "stateroom_subcategory_fare",
"id": "c75e3512-2713-3ed7-8c41-1b2b94831b8e"
}
]
},
"company": {
"links": {
"related": "/v1.1/company/2a15e462-7710-332a-b536-2ef4731d9dad"
},
"data": {
"type": "company",
"id": "2a15e462-7710-332a-b536-2ef4731d9dad"
}
},
"promotion_category": {
"links": {
"related": "/v1.1/promotion_category/e36e47fc-fbad-39e3-b7f3-319acb891855"
},
"data": {
"type": "promotion_category",
"id": "e36e47fc-fbad-39e3-b7f3-319acb891855"
}
},
"refundability": {
"links": {
"related": "/v1.1/refundability/f623e75a-f30e-32bb-973d-6df5b50bb7b5"
},
"data": {
"type": "refundability",
"id": "f623e75a-f30e-32bb-973d-6df5b50bb7b5"
}
},
"itinerary": {
"links": {
"related": "/v1.1/itinerary/41c9f2d0-7f17-3318-b72f-96aacb9f65b2"
},
"data": {
"type": "itinerary",
"id": "41c9f2d0-7f17-3318-b72f-96aacb9f65b2"
}
},
"stateroom_supracategory": {
"links": {
"related": "/v1.1/stateroom_supracategory/dd753679-4b63-3f90-accf-d37f9b147d7f"
},
"data": {
"type": "stateroom_supracategory",
"id": "dd753679-4b63-3f90-accf-d37f9b147d7f"
}
},
"ship": {
"links": {
"related": "/v1.1/ship/9508a19d-7801-307e-a7b7-628c31bfdd47"
},
"data": {
"type": "ship",
"id": "9508a19d-7801-307e-a7b7-628c31bfdd47"
}
}
},
"links": {
"self": "/v1.1/stateroom_category_fare/adb042b2-8648-36b8-8d66-ee5a0a11b035"
}
}
],
"meta": {
"count": 4
},
"included": [
{
"type": "stateroom_supracategory",
"id": "dd753679-4b63-3f90-accf-d37f9b147d7f",
"attributes": {
"code": "I",
"title": "Cabina interioara"
},
"links": {
"self": "/v1.1/stateroom_supracategory/dd753679-4b63-3f90-accf-d37f9b147d7f"
}
},
{
"type": "stateroom_category",
"id": "c45045e7-ade7-37c9-b259-a3fbc39e66e8",
"attributes": {
"title": "Cabine interioare",
"description": "...",
"image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/..."
},
"links": {
"self": "/v1.1/stateroom_category/c45045e7-ade7-37c9-b259-a3fbc39e66e8"
}
},
{
"type": "stateroom_subcategory_fare",
"id": "c75e3512-2713-3ed7-8c41-1b2b94831b8e",
"attributes": {
"departure": "2026-12-05",
"amount": 571,
"base_amount": 1150,
"savings_amount": 656,
"laf_amount": 494,
"nccf_amount": 388,
"port_tax_amount": 260
},
"relationships": {
"stateroom_subcategory": {
"links": {
"related": "/v1.1/stateroom_subcategory/815c00b4-bc33-30bd-95bd-f1ec94b6a439"
},
"data": {
"type": "stateroom_subcategory",
"id": "815c00b4-bc33-30bd-95bd-f1ec94b6a439"
}
},
"value_add": {
"links": {
"related": "/v1.1/value_add/d6ec61d6-70c4-319d-9f58-342f0ae63785"
},
"data": {
"type": "value_add",
"id": "d6ec61d6-70c4-319d-9f58-342f0ae63785"
}
},
"company": {
"data": {
"type": "company",
"id": "2a15e462-7710-332a-b536-2ef4731d9dad"
}
},
"promotion_category": {
"data": {
"type": "promotion_category",
"id": "e36e47fc-fbad-39e3-b7f3-319acb891855"
}
},
"refundability": {
"data": {
"type": "refundability",
"id": "f623e75a-f30e-32bb-973d-6df5b50bb7b5"
}
},
"itinerary": {
"data": {
"type": "itinerary",
"id": "41c9f2d0-7f17-3318-b72f-96aacb9f65b2"
}
},
"stateroom_supracategory": {
"data": {
"type": "stateroom_supracategory",
"id": "dd753679-4b63-3f90-accf-d37f9b147d7f"
}
},
"ship": {
"data": {
"type": "ship",
"id": "9508a19d-7801-307e-a7b7-628c31bfdd47"
}
}
},
"links": {
"self": "/v1.1/stateroom_subcategory_fare/c75e3512-2713-3ed7-8c41-1b2b94831b8e"
}
},
{
"type": "stateroom_subcategory",
"id": "815c00b4-bc33-30bd-95bd-f1ec94b6a439",
"attributes": {
"code": "4V",
"color": "96D1D9",
"title": "Cabina interioara Virtual Balcony",
"description": "...",
"surface_area": 16,
"image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/..."
},
"links": {
"self": "/v1.1/stateroom_subcategory/815c00b4-bc33-30bd-95bd-f1ec94b6a439"
}
},
{
"type": "value_add",
"id": "d6ec61d6-70c4-319d-9f58-342f0ae63785",
"attributes": {
"amount": 50
},
"relationships": {
"currency": {
"links": {
"related": "/v1.1/currency/3518f894-4d42-312d-937d-affe097d216e"
},
"data": {
"type": "currency",
"id": "3518f894-4d42-312d-937d-affe097d216e"
}
}
},
"links": {
"self": "/v1.1/value_add/d6ec61d6-70c4-319d-9f58-342f0ae63785"
}
},
{
"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"
}
}
],
"jsonapi": {
"version": "1.0"
}
}
Stateroom Category Fare Attributes
| Field | Type | Description |
|---|---|---|
departure | string | Departure date (ISO 8601) |
amount | number | Price per person |
savings_amount | number | Original price before savings |
Stateroom Category Fare Relationships
| Relationship | Type | Cardinality | Description |
|---|---|---|---|
stateroom_category | stateroom_category | one | The stateroom category |
value_add | value_add | one | Value-add promotion (e.g. onboard credit) |
stateroom_subcategory_fare | stateroom_subcategory_fare | many | Per-subcategory fare breakdowns |
company | company | one | Operating cruise line |
promotion_category | promotion_category | one | Applied promotion category |
refundability | refundability | one | Refundability policy |
itinerary | itinerary | one | The itinerary |
stateroom_supracategory | stateroom_supracategory | one | Cabin type (Interior, Ocean View, Balcony, Suite) |
ship | ship | one | The ship |
Stateroom Subcategory Fare Attributes (included)
| Field | Type | Description |
|---|---|---|
departure | string | Departure date (ISO 8601) |
amount | number | Price per person |
base_amount | number | Base fare before discounts |
savings_amount | number | Original price before savings |
laf_amount | number | LAF (fuel surcharge) amount |
nccf_amount | number | NCCF (non-commissionable cruise fare) amount |
port_tax_amount | number | Port taxes amount |
Value Add Attributes (included)
| Field | Type | Description |
|---|---|---|
amount | number | Value-add credit amount |
Included Resource Types
| Type | Description |
|---|---|
stateroom_supracategory | Cabin type (Interior, Ocean View, Balcony, Suite) |
stateroom_category | Stateroom category with description and image |
stateroom_subcategory_fare | Per-subcategory fare breakdowns with detailed pricing |
stateroom_subcategory | Subcategory details (code, color, surface area) |
value_add | Value-add promotions with currency relationship |
ship | Ship details |
company | Cruise line |
itinerary | Itinerary details |
region | Sailing region |
promotion_category | Promotion details |
refundability | Refundability policy |
facility | Facility/amenity group |
Error Responses
| Status | Description |
|---|---|
401 | Unauthorized — missing or invalid API key |
500 | Internal Server Error — upstream query failure |