GET /v1.1/fare
Returns a paginated list of all fares, with related company, ship, itinerary, region, port, stateroom subcategory, stateroom supracategory, promotion category, and refundability data included.
Request
GET /v1.1/fare
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
page[number] | integer | 1 | Page number (one-indexed) |
page[size] | integer | 10 | Items per page (max 1000) |
Example Request
curl -X GET "https://api.rccl.ro/v1.1/fare?page[number]=1&page[size]=10" \
-H "X-WorldTravel-ApiKey: YOUR_API_KEY"
Response
200 OK
Returns an array of fare resources with related objects included.
Response body:
{
"data": [
{
"type": "fare",
"id": "0f4cd52d-525d-3450-bd70-f56fbc25fa78",
"attributes": {
"departure": "2027-05-30",
"amount": 2113.5,
"passenger_1_amount": 2320,
"passenger_2_amount": 1121,
"departure_tax": 171,
"port_tax": 222,
"passenger_1_tax": 393,
"passenger_2_tax": 393
},
"relationships": {
"stateroom_subcategory": {
"links": {
"related": "/v1.1/stateroom_subcategory/5ddb769e-2969-3ae0-baac-41259e1ee3d9"
},
"data": {
"type": "stateroom_subcategory",
"id": "5ddb769e-2969-3ae0-baac-41259e1ee3d9"
}
},
"company": {
"links": {
"related": "/v1.1/company/2a15e462-7710-332a-b536-2ef4731d9dad"
},
"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"
}
},
"port": {
"links": {
"related": "/v1.1/port/2ab3e8c8-b158-3343-bc7f-8aae9d9dfa6b"
},
"data": {
"type": "port",
"id": "2ab3e8c8-b158-3343-bc7f-8aae9d9dfa6b"
}
},
"itinerary": {
"links": {
"related": "/v1.1/itinerary/028a4d84-d017-328a-b6ca-f5d6fe76ee7e"
},
"data": {
"type": "itinerary",
"id": "028a4d84-d017-328a-b6ca-f5d6fe76ee7e"
}
},
"stateroom_supracategory": {
"links": {
"related": "/v1.1/stateroom_supracategory/f623e75a-f30e-32bb-973d-6df5b50bb7b5"
},
"data": {
"type": "stateroom_supracategory",
"id": "f623e75a-f30e-32bb-973d-6df5b50bb7b5"
}
},
"ship": {
"links": {
"related": "/v1.1/ship/33416c8a-3cd0-3b84-b92e-e63a071fa28f"
},
"data": {
"type": "ship",
"id": "33416c8a-3cd0-3b84-b92e-e63a071fa28f"
}
},
"region": {
"links": {
"related": "/v1.1/region/9fd3aeee-3f27-3f2d-bf31-8fdb82141d1b"
},
"data": {
"type": "region",
"id": "9fd3aeee-3f27-3f2d-bf31-8fdb82141d1b"
}
},
"promotion_category": {
"links": {
"related": "/v1.1/promotion_category/e36e47fc-fbad-39e3-b7f3-319acb891855"
},
"data": {
"type": "promotion_category",
"id": "e36e47fc-fbad-39e3-b7f3-319acb891855"
}
}
},
"links": {
"self": "/v1.1/fare/0f4cd52d-525d-3450-bd70-f56fbc25fa78"
}
}
],
"links": {
"self": "/v1.1/fare",
"first": "/v1.1/fare?page[number]=1&page[size]=10",
"next": "/v1.1/fare?page[number]=2&page[size]=10"
},
"meta": {
"count": 15234
},
"included": [
{
"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": "ship",
"id": "33416c8a-3cd0-3b84-b92e-e63a071fa28f",
"attributes": {
"code": "OY",
"title": "Odyssey of the Seas",
"description": "..."
},
"links": {
"self": "/v1.1/ship/33416c8a-3cd0-3b84-b92e-e63a071fa28f"
}
},
{
"type": "stateroom_subcategory",
"id": "5ddb769e-2969-3ae0-baac-41259e1ee3d9",
"attributes": {
"code": "WS",
"color": "000000",
"title": "Apartament garantat",
"description": "..."
},
"links": {
"self": "/v1.1/stateroom_subcategory/5ddb769e-2969-3ae0-baac-41259e1ee3d9"
}
},
{
"type": "stateroom_supracategory",
"id": "f623e75a-f30e-32bb-973d-6df5b50bb7b5",
"attributes": {
"code": "D",
"title": "Apartament"
},
"links": {
"self": "/v1.1/stateroom_supracategory/f623e75a-f30e-32bb-973d-6df5b50bb7b5"
}
},
{
"type": "promotion_category",
"id": "e36e47fc-fbad-39e3-b7f3-319acb891855",
"attributes": {
"code": "CD381350",
"description": "BOGO60 NRD"
},
"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"
}
}
],
"jsonapi": {
"version": "1.0"
}
}
Fare Attributes
| Field | Type | Description |
|---|---|---|
departure | string | Departure date (ISO 8601) |
amount | number | Average price per person |
passenger_1_amount | number | First passenger fare amount |
passenger_2_amount | number | Second passenger fare amount |
departure_tax | number | Departure tax amount |
port_tax | number | Port tax amount |
passenger_1_tax | number | First passenger total taxes |
passenger_2_tax | number | Second passenger total taxes |
Relationships
| Relationship | Type | Cardinality | Description |
|---|---|---|---|
stateroom_subcategory | stateroom_subcategory | one | The stateroom subcategory |
company | company | one | Operating cruise line |
refundability | refundability | one | Refundability policy |
port | port | one | Departure port |
itinerary | itinerary | one | The itinerary |
stateroom_supracategory | stateroom_supracategory | one | Cabin type (Interior, Ocean View, Balcony, Suite) |
ship | ship | one | The ship |
region | region | one | Sailing region |
promotion_category | promotion_category | one | Applied promotion category |
Included Resource Types
| Type | Description |
|---|---|
company | Cruise line details |
ship | Ship details |
stateroom_subcategory | Subcategory details |
stateroom_supracategory | Cabin type |
promotion_category | Promotion details |
refundability | Refundability policy |
Error Responses
| Status | Description |
|---|---|
401 | Unauthorized — missing or invalid API key |
500 | Internal Server Error — upstream query failure |