POST /v1.1/search/pricing

Get full pricing breakdown for a specific booking configuration. Returns a single guests charge resource with per-guest charges, savings breakdowns, cancellation policy, and a PDF offer URL.

Request

POST /v1.1/search/pricing

Request Body

{
  "departure": {
    "date": "20261205"
  },
  "itinerary": {
    "code": "07D519",
    "ship": {
      "code": "RH"
    }
  },
  "promotion": {
    "code": "BESTRATE"
  },
  "guests": {
    "adults": 2,
    "children": 0
  },
  "stateroom_subcategory": {
    "code": "4B"
  },
  "stateroom": {
    "code": "7014"
  },
  "sitting": {
    "code": "O"
  },
  "include_gratuities": true
}

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
promotion.code	string	No	Promotion code (e.g. BESTRATE)
guests.adults	integer	Yes	Number of adult guests
guests.children	integer	Yes	Number of child guests
stateroom_subcategory.code	string	Yes	Stateroom subcategory code
stateroom.code	string	Yes	Cabin number
sitting.code	string	Yes	Dining sitting category code
include_gratuities	boolean	No	Include gratuities in pricing

Example Request

curl -X POST "https://api.rccl.ro/v1.1/search/pricing" \
  -H "X-WorldTravel-ApiKey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "departure": { "date": "20261205" },
    "itinerary": { "code": "07D519", "ship": { "code": "RH" } },
    "promotion": { "code": "BESTRATE" },
    "guests": { "adults": 2, "children": 0 },
    "stateroom_subcategory": { "code": "4B" },
    "stateroom": { "code": "7014" },
    "sitting": { "code": "O" },
    "include_gratuities": true
  }'

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" },
                    { "type": "cancellation", "id": "5fe0acae-4f29-318a-bca6-54d1390a1620" },
                    { "type": "cancellation", "id": "83caeb86-19c1-36e9-97bd-120d4f2120ec" }
                ]
            },
            "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 include_gratuities is true)
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

Guests Charge 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

Guest Charge Attributes (included)

Per-guest pricing breakdown (one per guest):

Field	Type	Description
subtotal_amount	number	Guest subtotal
tax_amount	number	Guest taxes
total_amount	number	Guest total
total_savings_amount	number	Guest total savings
gratuities_amount	number	Guest gratuities
payment_amount	number	Guest payment amount
child	boolean	Whether this is a child guest

Cancellation Attributes (included)

Cancellation penalty periods ordered chronologically:

Field	Type	Description
departure	string	Departure date
fcc	boolean	Whether future cruise credit applies
from_date	string	Period start date (ISO 8601)
to_date	string	Period end date (ISO 8601)
penalty_amount	number	Fixed penalty amount per person (if applicable)
penalty_percentage	number	Percentage penalty (0.5 = 50%, if applicable)
text	string	Human-readable cancellation text

Savings Attributes (included)

Both guests_savings (total) and guest_savings (per-guest) share the same structure:

Field	Type	Description
amount	number	Savings amount
description	string	Savings description (e.g. Savings NRD, BOGO60 NRD)

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 — upstream query failure