POST /v1.1/search/subcategories
Search for stateroom subcategory fares within a specific supracategory (e.g. Balcony) for a sailing. Returns per-subcategory pricing with detailed fare breakdowns.
Request
POST /v1.1/search/subcategories
Request Body
{
"departure": {
"date": "20261205"
},
"itinerary": {
"code": "07D519",
"ship": {
"code": "RH"
}
},
"guests": {
"adults": 2,
"children": 0
},
"promotion": {
"code": "BESTRATE"
},
"stateroom_supracategory": {
"code": "B"
}
}
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 |
promotion.code | string | No | Promotion code (e.g. BESTRATE) |
stateroom_supracategory.code | string | Yes | Supracategory code to filter by (e.g. I Interior, O Ocean View, B Balcony, D Suite) |
Example Request
curl -X POST "https://api.rccl.ro/v1.1/search/subcategories" \
-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 },
"promotion": { "code": "BESTRATE" },
"stateroom_supracategory": { "code": "B" }
}'
Response
200 OK
Returns an array of stateroom subcategory fare resources with related objects included.
Response body (truncated to first item):
{
"data": [
{
"type": "stateroom_subcategory_fare",
"id": "a13b9c1f-a75a-369c-a4a9-e56f447f8c92",
"attributes": {
"departure": "2026-12-05",
"amount": 1121.5,
"base_amount": 2816,
"savings_amount": 1221,
"laf_amount": 1595,
"nccf_amount": 388,
"port_tax_amount": 260
},
"relationships": {
"stateroom_subcategory": {
"links": {
"related": "/v1.1/stateroom_subcategory/a41406d2-bdc1-33a2-a8b3-7739803fe146"
},
"data": {
"type": "stateroom_subcategory",
"id": "a41406d2-bdc1-33a2-a8b3-7739803fe146"
}
},
"value_add": {
"links": {
"related": "/v1.1/value_add/d6ec61d6-70c4-319d-9f58-342f0ae63785"
},
"data": {
"type": "value_add",
"id": "d6ec61d6-70c4-319d-9f58-342f0ae63785"
}
},
"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/9d5ed678-fe57-3cca-a101-40957afab571"
},
"data": {
"type": "stateroom_supracategory",
"id": "9d5ed678-fe57-3cca-a101-40957afab571"
}
},
"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_subcategory_fare/a13b9c1f-a75a-369c-a4a9-e56f447f8c92"
}
}
],
"meta": {
"count": 4
},
"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": "itinerary",
"id": "41c9f2d0-7f17-3318-b72f-96aacb9f65b2",
"attributes": {
"code": "07D519",
"adult_age": 21,
"child_age": 12,
"title": "Croazier\u0103 \u00een Caraibele de Est",
"nights": 7,
"hero_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/croaziere-in-caraibe-san-juan-puerto-ricoi-hero-1920x800-il-rci-02.jpg",
"thumb_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/croaziere-in-caraibe-san-juan-puerto-ricoi-thumb-900x900-il-rci-02.jpg",
"include_url": "https://rccl.ro/ce-include-tariful-croazierei/royal-caribbean",
"earliest_departure": "2026-11-07",
"roundtrip": true
},
"relationships": {
"company": {
"data": {
"type": "company",
"id": "2a15e462-7710-332a-b536-2ef4731d9dad"
}
},
"ship": {
"data": {
"type": "ship",
"id": "9508a19d-7801-307e-a7b7-628c31bfdd47"
}
},
"region": {
"links": {
"related": "/v1.1/region/2e68a730-fe6a-3961-b469-6960b9af34c8"
},
"data": {
"type": "region",
"id": "2e68a730-fe6a-3961-b469-6960b9af34c8"
}
},
"port": {
"data": [
{ "type": "port", "id": "edb65fd3-d096-354a-ace9-630ddbad8e67" },
{ "type": "port", "id": "9d82ed81-6b6f-3b88-986b-476e7740c977" },
{ "type": "port", "id": "db8faad9-e67f-3bc2-8b00-0e10d60de875" },
{ "type": "port", "id": "91c69eae-4870-3c9f-a441-ed628bed5560" },
{ "type": "port", "id": "a8e01488-1fe1-3836-b56d-8e41ecf76a76" },
{ "type": "port", "id": "05665b78-26ff-3608-8709-4429e8a32116" },
{ "type": "port", "id": "edb65fd3-d096-354a-ace9-630ddbad8e67" }
]
}
},
"links": {
"self": "/v1.1/itinerary/41c9f2d0-7f17-3318-b72f-96aacb9f65b2"
}
},
{
"type": "region",
"id": "2e68a730-fe6a-3961-b469-6960b9af34c8",
"attributes": {
"code": "CARIB",
"title": "Caraibe",
"image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/croaziere-in-caraibe-bermuda-snorkeling-thumb-900x900-il-cel-01.jpg"
},
"links": {
"self": "/v1.1/region/2e68a730-fe6a-3961-b469-6960b9af34c8"
}
},
{
"type": "stateroom_supracategory",
"id": "9d5ed678-fe57-3cca-a101-40957afab571",
"attributes": {
"code": "B",
"title": "Cabina cu balcon"
},
"links": {
"self": "/v1.1/stateroom_supracategory/9d5ed678-fe57-3cca-a101-40957afab571"
}
},
{
"type": "stateroom_subcategory",
"id": "a41406d2-bdc1-33a2-a8b3-7739803fe146",
"attributes": {
"code": "XB",
"color": "000000",
"title": "Cabina cu balcon cu vedere la ocean garantata",
"description": "...",
"image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/2019/03/RH_Cabina_3B.jpg"
},
"relationships": {
"ship": {
"data": {
"type": "ship",
"id": "9508a19d-7801-307e-a7b7-628c31bfdd47"
}
},
"facility": {
"links": {
"related": "/v1.1/facility/d4dd111a-4fd9-3339-8238-aca5c05bebe3"
},
"data": {
"type": "facility",
"id": "d4dd111a-4fd9-3339-8238-aca5c05bebe3"
}
}
},
"links": {
"self": "/v1.1/stateroom_subcategory/a41406d2-bdc1-33a2-a8b3-7739803fe146"
}
},
{
"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": "promotion_category",
"id": "e36e47fc-fbad-39e3-b7f3-319acb891855",
"attributes": {
"code": "CD381350",
"description": "BOGO60 NRD"
},
"relationships": {
"company": {
"data": {
"type": "company",
"id": "2a15e462-7710-332a-b536-2ef4731d9dad"
}
},
"refundability": {
"links": {
"related": "/v1.1/refundability/f623e75a-f30e-32bb-973d-6df5b50bb7b5"
},
"data": {
"type": "refundability",
"id": "f623e75a-f30e-32bb-973d-6df5b50bb7b5"
}
}
},
"links": {
"self": "/v1.1/promotion_category/e36e47fc-fbad-39e3-b7f3-319acb891855"
}
},
{
"type": "refundability",
"id": "f623e75a-f30e-32bb-973d-6df5b50bb7b5",
"attributes": {
"code": "D",
"description": "Tarife cu depozit nerambursabil"
},
"links": {
"self": "/v1.1/refundability/f623e75a-f30e-32bb-973d-6df5b50bb7b5"
}
},
{
"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"
}
}
],
"jsonapi": {
"version": "1.0"
}
}
Stateroom Subcategory Fare Attributes
| 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 |
Relationships
| Relationship | Type | Cardinality | Description |
|---|---|---|---|
stateroom_subcategory | stateroom_subcategory | one | The stateroom subcategory |
value_add | value_add | one | Value-add promotion (e.g. onboard credit) |
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 |
Included Resource Types
| Type | Description |
|---|---|
ship | Ship details |
company | Cruise line details |
itinerary | Itinerary details (title, nights, ports, region) |
region | Sailing region |
stateroom_supracategory | Cabin type (e.g. Balcony) |
stateroom_subcategory | Subcategory details (code, color, title, description, image) |
facility | Facility/amenity group |
promotion_category | Promotion details with refundability |
refundability | Refundability policy |
value_add | Value-add promotions with currency relationship |
Error Responses
| Status | Description |
|---|---|
401 | Unauthorized — missing or invalid API key |
500 | Internal Server Error — upstream query failure |