GET /v1.1/guests_charge/:id
Returns a single guests charge resource by its ID, containing the full pricing breakdown for all guests in a booking configuration.
Request
GET /v1.1/guests_charge/:id
URL Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The guests charge ID |
Example Request
curl -X GET "https://api.rccl.ro/v1.1/guests_charge/457829d3-e9e0-3a9a-9c77-2079665166b7" \
-H "X-WorldTravel-ApiKey: YOUR_API_KEY"
Response
200 OK
Returns a single guests charge resource with related objects included.
Response body (included array truncated):
{
"data": {
"type": "guests_charge",
"id": "457829d3-e9e0-3a9a-9c77-2079665166b7",
"attributes": {
"departure": "2026-12-05",
"adults": 2,
"children": 0,
"base_fare_amount": 3290,
"base_nccf_amount": 388,
"fare_amount": 1927,
"fare_saving_amount": 1363,
"nccf_amount": 388,
"subtotal_amount": 2315,
"total_amount": 2575,
"total_savings_amount": 1363,
"tax_amount": 260,
"gratuities_amount": 233.2,
"payment_amount": 2808.2,
"payment_date": "2026-10-01",
"deposit_amount": 165,
"deposit_date": "2026-02-10",
"pdf": "https://rccl.ro/wp-json/rccl/v2/generate-offer-api?values=..."
},
"relationships": {
"stateroom_subcategory": {
"links": {
"related": "/v1.1/stateroom_subcategory/55523f76-70a2-3ea9-8e77-e68cb819c503"
},
"data": {
"type": "stateroom_subcategory",
"id": "55523f76-70a2-3ea9-8e77-e68cb819c503"
}
},
"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"
}
},
"guest_charge": {
"data": [
{
"type": "guest_charge",
"id": "580d1bbc-00df-31f8-bce5-d6f92e37e325"
},
{
"type": "guest_charge",
"id": "d6341134-0e82-35f6-bb7c-91a0db299783"
}
]
},
"sitting_category": {
"links": {
"related": "/v1.1/sitting_category/f1862177-53c3-3b9b-9f95-8d906208506e"
},
"data": {
"type": "sitting_category",
"id": "f1862177-53c3-3b9b-9f95-8d906208506e"
}
},
"stateroom": {
"links": {
"related": "/v1.1/stateroom/113b8879-e07e-30b3-8c0f-f28605cf1ba4"
},
"data": {
"type": "stateroom",
"id": "113b8879-e07e-30b3-8c0f-f28605cf1ba4"
}
},
"cancellation": {
"data": [
{ "type": "cancellation", "id": "8590ff18-33cc-3120-a16c-023f2f652d19" },
{ "type": "cancellation", "id": "a4d3bd09-e58f-3ca9-b6c2-abb23fe94360" },
{ "type": "cancellation", "id": "4450fd3c-d0d9-333a-b986-e7b1ed2f3bf7" }
]
},
"itinerary": {
"links": {
"related": "/v1.1/itinerary/41c9f2d0-7f17-3318-b72f-96aacb9f65b2"
},
"data": {
"type": "itinerary",
"id": "41c9f2d0-7f17-3318-b72f-96aacb9f65b2"
}
},
"refundability": {
"links": {
"related": "/v1.1/refundability/f623e75a-f30e-32bb-973d-6df5b50bb7b5"
},
"data": {
"type": "refundability",
"id": "f623e75a-f30e-32bb-973d-6df5b50bb7b5"
}
},
"guests_savings": {
"data": [
{ "type": "guests_savings", "id": "2daa6611-c46f-381c-9a44-f04f70614d65" },
{ "type": "guests_savings", "id": "2bd6c47c-0228-3b4d-91f6-52d6976f4d6e" }
]
},
"promotion_category": {
"links": {
"related": "/v1.1/promotion_category/caa2791a-60cc-3086-9d37-05b9b521fbd9"
},
"data": {
"type": "promotion_category",
"id": "caa2791a-60cc-3086-9d37-05b9b521fbd9"
}
},
"currency": {
"links": {
"related": "/v1.1/currency/a055562b-db59-3d8b-a9cc-680367308118"
},
"data": {
"type": "currency",
"id": "a055562b-db59-3d8b-a9cc-680367308118"
}
}
},
"links": {
"self": "/v1.1/guests_charge/457829d3-e9e0-3a9a-9c77-2079665166b7"
}
},
"links": {
"self": "/v1.1/guests_charge/457829d3-e9e0-3a9a-9c77-2079665166b7"
},
"included": ["..."],
"jsonapi": {
"version": "1.0"
}
}
Guests Charge Attributes
| Field | Type | Description |
|---|---|---|
departure | string | Departure date (ISO 8601) |
adults | integer | Number of adult guests |
children | integer | Number of child guests |
base_fare_amount | number | Base fare before discounts (all guests) |
base_nccf_amount | number | Base NCCF amount |
fare_amount | number | Fare after discounts (all guests) |
fare_saving_amount | number | Total fare savings |
nccf_amount | number | Non-commissionable cruise fare |
subtotal_amount | number | Subtotal (fare + NCCF) |
total_amount | number | Total including taxes |
total_savings_amount | number | Total savings amount |
tax_amount | number | Port taxes |
gratuities_amount | number | Gratuities (when included) |
payment_amount | number | Final payment amount (total + gratuities) |
payment_date | string | Final payment due date (ISO 8601) |
deposit_amount | number | Deposit amount per person |
deposit_date | string | Deposit due date (ISO 8601) |
pdf | string | URL to generate a PDF offer document |
Relationships
| Relationship | Type | Cardinality | Description |
|---|---|---|---|
stateroom_subcategory | stateroom_subcategory | one | The stateroom subcategory |
company | company | one | Operating cruise line |
ship | ship | one | The ship |
guest_charge | guest_charge | many | Per-guest charge breakdowns |
sitting_category | sitting_category | one | Selected dining sitting |
stateroom | stateroom | one | Selected cabin |
cancellation | cancellation | many | Cancellation policy periods |
itinerary | itinerary | one | The itinerary |
refundability | refundability | one | Refundability policy |
guests_savings | guests_savings | many | Total savings breakdowns |
promotion_category | promotion_category | one | Applied promotion |
currency | currency | one | Pricing currency |
Included Resource Types
| Type | Description |
|---|---|
company | Cruise line details |
ship | Ship details |
itinerary | Itinerary with ports and region |
region | Sailing region |
stateroom_subcategory | Subcategory details |
facility | Facility/amenity group |
stateroom | Full cabin details |
deck | Deck with plan image and legend |
stateroom_attribute | Cabin feature attributes |
bed | Bed type configuration |
stateroom_positioning | Ship position with diagram |
shower | Shower type |
sitting_category | Dining sitting category |
promotion_category | Promotion with refundability |
refundability | Refundability policy |
currency | Currency code and symbol |
guest_charge | Per-guest charge breakdown |
guest_savings | Per-guest savings with savings category |
guests_savings | Total savings with savings category |
savings_category | Savings category code |
cancellation | Cancellation penalty period |
cancellation_note | Additional cancellation notes |
Error Responses
| Status | Description |
|---|---|
401 | Unauthorized — missing or invalid API key |
500 | Internal Server Error — guests charge not found or upstream query failure |