WorldTravel API v1.1

REST API for cruise ship inventory, pricing, and booking operations.

Base URL

https://api.rccl.ro/v1.1

Authentication

All endpoints require authentication via the X-WorldTravel-ApiKey header:

X-WorldTravel-ApiKey: <your-api-key>

Response Format

All responses follow the JSON:API 1.0 specification. Every response includes:

Field	Description
data	Primary resource object or array of resource objects
links	Pagination and self-referencing links
included	Sideloaded related resources (eager-loaded)
jsonapi	JSON:API version metadata
meta	Collection metadata (e.g. total count)

Pagination

Collection endpoints support pagination via query parameters:

Parameter	Default	Max	Description
page[number]	1	—	One-indexed page number
page[size]	10	1000	Number of items per page

Pagination links are included in the links object of the response:

{
  "links": {
    "self": "/v1.1/ship",
    "first": "/v1.1/ship?page[number]=1&page[size]=10",
    "next": "/v1.1/ship?page[number]=2&page[size]=10"
  }
}

Endpoints

Files

Method	Endpoint	Description
GET	/v1.1/files	List files for offline processing

Search

Method	Endpoint	Description
GET	/v1.1/search	Search sailings with filters
GET	/v1.1/search/days	Search itinerary days (filtered)
POST	/v1.1/search/categories	Search stateroom category fares for a sailing
POST	/v1.1/search/subcategories	Search subcategory fares within a supracategory
POST	/v1.1/search/staterooms	Search available staterooms for a sailing
POST	/v1.1/search/stateroom	Get detailed stateroom info for a specific cabin
POST	/v1.1/search/hold	Place a temporary hold on a stateroom
POST	/v1.1/search/release	Release a previously held stateroom
POST	/v1.1/search/promotions	Search promotions for a sailing and subcategory
POST	/v1.1/search/dining	Search dining sittings for a sailing and subcategory
POST	/v1.1/search/pricing	Get full pricing breakdown for a booking configuration

Booking

Method	Endpoint	Description
POST	/v1.1/book	Create a booking with guest details
GET	/v1.1/booking/:id	Get a single booking

Objects

Loading diagram...

Method	Endpoint	Description
GET	/v1.1/bed	List all bed types
GET	/v1.1/bed/:id	Get a single bed type
GET	/v1.1/cancellation/:id	Get a single cancellation
GET	/v1.1/cancellation_note/:id	Get a single cancellation note
GET	/v1.1/company	List all companies
GET	/v1.1/company/:id	Get a single company
GET	/v1.1/country	List all countries
GET	/v1.1/country/:id	Get a single country
GET	/v1.1/currency	List all currencies
GET	/v1.1/currency/:id	Get a single currency
GET	/v1.1/deck	List all decks
GET	/v1.1/deck/:id	Get a single deck
GET	/v1.1/deck_image	List all deck images
GET	/v1.1/deck_image/:id	Get a single deck image
GET	/v1.1/facility	List all facilities
GET	/v1.1/facility/:id	Get a single facility
GET	/v1.1/fare	List all fares
GET	/v1.1/fare/:id	Get a single fare
GET	/v1.1/gender	List all genders
GET	/v1.1/gender/:id	Get a single gender
GET	/v1.1/guest_charge/:id	Get a single guest charge
GET	/v1.1/guest_savings/:id	Get a single guest savings
GET	/v1.1/guests_charge/:id	Get a single guests charge
GET	/v1.1/guests_savings/:id	Get a single guests savings
GET	/v1.1/hold/:id	Get a single hold
GET	/v1.1/itinerary	List all itineraries
GET	/v1.1/itinerary/:id	Get a single itinerary
GET	/v1.1/itinerary_day	List all itinerary days
GET	/v1.1/itinerary_day/:id	Get a single itinerary day
GET	/v1.1/port	List all ports
GET	/v1.1/port/:id	Get a single port
GET	/v1.1/promotion/:id	Get a single promotion
GET	/v1.1/promotion_category	List all promotion categories
GET	/v1.1/promotion_category/:id	Get a single promotion category
GET	/v1.1/refundability	List all refundability policies
GET	/v1.1/refundability/:id	Get a single refundability policy
GET	/v1.1/region	List all regions
GET	/v1.1/region/:id	Get a single region
GET	/v1.1/release/:id	Get a single release
GET	/v1.1/sailing_state	List all sailing states
GET	/v1.1/sailing_state/:id	Get a single sailing state
GET	/v1.1/savings_category	List all savings categories
GET	/v1.1/savings_category/:id	Get a single savings category
GET	/v1.1/ship	List all ships
GET	/v1.1/ship/:id	Get a single ship
GET	/v1.1/shower	List all shower types
GET	/v1.1/shower/:id	Get a single shower type
GET	/v1.1/sitting/:id	Get a single sitting
GET	/v1.1/sitting_category	List all sitting categories
GET	/v1.1/sitting_category/:id	Get a single sitting category
GET	/v1.1/special_service/:id	Get a single special service
GET	/v1.1/stateroom/:id	Get a single stateroom
GET	/v1.1/stateroom_attribute	List all stateroom attributes
GET	/v1.1/stateroom_attribute/:id	Get a single stateroom attribute
GET	/v1.1/stateroom_category	List all stateroom categories
GET	/v1.1/stateroom_category/:id	Get a single stateroom category
GET	/v1.1/stateroom_category_fare/:id	Get a single stateroom category fare
GET	/v1.1/stateroom_positioning	List all stateroom positionings
GET	/v1.1/stateroom_positioning/:id	Get a single stateroom positioning
GET	/v1.1/stateroom_subcategory	List all stateroom subcategories
GET	/v1.1/stateroom_subcategory/:id	Get a single stateroom subcategory
GET	/v1.1/stateroom_subcategory_fare/:id	Get a single stateroom subcategory fare
GET	/v1.1/stateroom_supracategory	List all stateroom supracategories
GET	/v1.1/stateroom_supracategory/:id	Get a single stateroom supracategory
GET	/v1.1/title	List all titles
GET	/v1.1/title/:id	Get a single title
GET	/v1.1/value_add/:id	Get a single value-add