GET /v1.1/fare/:id

Returns a single fare by its ID, with related company, ship, itinerary, region, stateroom subcategory, stateroom supracategory, promotion category, and refundability data included.

Request

GET /v1.1/fare/:id

URL Parameters

Parameter	Type	Required	Description
`id`	string	Yes	The fare ID

Example Request

curl -X GET "https://api.rccl.ro/v1.1/fare/0f4cd52d-525d-3450-bd70-f56fbc25fa78" \
  -H "X-WorldTravel-ApiKey: YOUR_API_KEY"

Response

200 OK

Returns a single fare resource 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/0f4cd52d-525d-3450-bd70-f56fbc25fa78"
    },
    "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 — fare not found or upstream query failure

Request​

URL Parameters​

Example Request​

Response​

200 OK​

Fare Attributes​

Relationships​

Included Resource Types​

Error Responses​