GET /v1.1/search

Search for available sailings with advanced filtering, sorting, and pagination. Returns matching sailings with all related resources included.

Search on rccl.ro

Need bulk data without rate limits?

Use /v1.1/files instead. It provides the same pricing data as pre-built NDJSON exports via signed URLs — with no rate limits.

Request

GET /v1.1/search

Query Parameters

Pagination

Parameter	Type	Default	Max	Description
`page[number]`	integer	`1`	—	Page number (one-indexed)
`page[size]`	integer	`10`	`20`	Items per page

Sorting

Parameter	Type	Default	Description
`sort`	string	`-amount`	Sort order for results

Sort values:

Value	Description
`-amount`	Price descending (default)
`amount`	Price ascending
`departure`	Departure date ascending
`nights`	Number of nights ascending

Filters

Filters are passed as a URL-encoded JSON object in the filter[objects] query parameter.

Parameter	Type	Description
`filter[objects]`	JSON string	Complex filter object (see structure below)

Filter object structure:

{
  "price": {
    "from": 100,
    "to": 100000
  },
  "nights": {
    "from": 2,
    "to": 30
  },
  "departure": {
    "from": "20260205",
    "to": "20290205"
  },
  "region": {
    "codes": ["EUROP"]
  },
  "company": {
    "codes": ["RCC"]
  },
  "ship": {
    "codes": ["OY"]
  },
  "stateroom_supracategory": {
    "codes": ["D"]
  },
  "port": {
    "codes": ["ROM"]
  },
  "itinerary": {
    "codes": ["07M869"]
  }
}

Filter fields:

Field	Type	Description
`departure.from`	string	Earliest departure date (`YYYYMMDD` format)
`departure.to`	string	Latest departure date (`YYYYMMDD` format)
`nights.from`	integer	Minimum number of nights
`nights.to`	integer	Maximum number of nights
`price.from`	float	Minimum price
`price.to`	float	Maximum price
`ship.codes`	string[]	Filter by ship codes
`itinerary.codes`	string[]	Filter by itinerary codes
`company.codes`	string[]	Filter by company codes
`stateroom_supracategory.codes`	string[]	Filter by stateroom supracategory codes (I=Interior, O=Ocean View, B=Balcony, D=Deluxe)
`region.codes`	string[]	Filter by region codes
`port.codes`	string[]	Filter by port codes

All filter fields are optional. Omit any field to skip that filter.

Example Request

curl -G "https://api.rccl.ro/v1.1/search" \
  -H "X-WorldTravel-ApiKey: YOUR_API_KEY" \
  --data-urlencode 'page[number]=1' \
  --data-urlencode 'page[size]=10' \
  --data-urlencode 'sort=amount' \
  --data-urlencode 'filter[objects]={"price":{"from":100,"to":100000},"nights":{"from":2,"to":30},"departure":{"from":"20260205","to":"20290205"},"region":{"codes":["EUROP"]},"company":{"codes":["RCC"]},"ship":{"codes":["OY"]},"stateroom_supracategory":{"codes":["D"]},"port":{"codes":["ROM"]},"itinerary":{"codes":["07M869"]}}'

Response

200 OK

Returns an array of sailing resources with all related resources included.

Response body:

{
  "data": [
    {
      "type": "sailing",
      "id": "OY07M869",
      "attributes": {
        "departure": "2027-10-24",
        "amount": 1857.5,
        "title": "Croazieră în Italia, Grecia si Turcia",
        "nights": 7,
        "ports": [
          "Roma (Civitavecchia), Italia",
          "Santorini, Grecia",
          "Efes (Kusadasi), Turcia",
          "Mykonos, Grecia",
          "Napoli, Italia",
          "Roma (Civitavecchia), Italia"
        ],
        "thumb_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/croaziere-in-mediterana-italia-roma-coloseum-thumb-900x900-il-cel-01.jpg"
      },
      "relationships": {
        "fare": {
          "data": [
            { "type": "fare", "id": "0f4cd52d-525d-3450-bd70-f56fbc25fa78" },
            { "type": "fare", "id": "e7d14c1c-dce7-35e2-aafc-deba879bbb68" }
          ]
        },
        "lowest_fare": {
          "links": { "related": "/v1.1/fare/aaaa36a8-4b29-3327-92d4-61d604aa04c2" },
          "data": { "type": "fare", "id": "aaaa36a8-4b29-3327-92d4-61d604aa04c2" }
        },
        "company": {
          "links": { "related": "/v1.1/company/2a15e462-7710-332a-b536-2ef4731d9dad" },
          "data": { "type": "company", "id": "2a15e462-7710-332a-b536-2ef4731d9dad" }
        },
        "region": {
          "links": { "related": "/v1.1/region/9fd3aeee-3f27-3f2d-bf31-8fdb82141d1b" },
          "data": { "type": "region", "id": "9fd3aeee-3f27-3f2d-bf31-8fdb82141d1b" }
        },
        "port": {
          "data": [
            { "type": "port", "id": "2ab3e8c8-b158-3343-bc7f-8aae9d9dfa6b" },
            { "type": "port", "id": "58e0a980-7b9d-373b-88a0-65d2d71f9fc8" },
            { "type": "port", "id": "1180214a-aa47-3661-92de-d5bf02abc75b" },
            { "type": "port", "id": "5784856a-7703-39e8-85b5-9f7a6e262643" },
            { "type": "port", "id": "6d6f95d0-8962-3559-8deb-68c746675543" },
            { "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": {
          "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" }
        }
      },
      "links": {
        "self": "/v1.1/search?filter[objects]=..."
      }
    }
  ],
  "meta": {
    "count": 1
  },
  "included": [
    {
      "type": "company",
      "id": "2a15e462-7710-332a-b536-2ef4731d9dad",
      "attributes": {
        "code": "RCC",
        "title": "Royal Caribbean International®",
        "description": "Royal Caribbean International® ...",
        "hero_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/Croaziera_Harmony_of_the_Seas_Hero-1.jpg",
        "logo_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/royal_logo-2.png",
        "site_url": "https://rccl.ro/branduri-croaziera/royal-caribbean-international",
        "terms_of_service_url": "https://rccl.ro/termeni-si-conditii-de-rezervare-croaziere-royal-caribbean-international",
        "non_refundability_terms_url": "https://rccl.ro/tarife-cu-depozit-nerambursabil-royal-caribbean-international",
        "gratuities_included": false,
        "dining_description": "...",
        "dining_image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/CEL_PR_JUN02_ENHANCED-CONCIERGE-80-opacity.jpg",
        "gratuity_description": "...",
        "gratuity_image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/CEL-BY-guest-service-il-cel-01.jpg",
        "deck_legend_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/legenda-plan-punti-Royal.png"
      },
      "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": "...",
        "image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/rci-odyssey-aerial.jpg",
        "hero_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/odyssey-of-the-seas-aerial-night-hero.jpg",
        "inauguration": 2021,
        "capacity": 5498,
        "crew": 1550,
        "decks": 16,
        "speed": "22"
      },
      "relationships": {
        "company": {
          "links": { "related": "/v1.1/company/2a15e462-7710-332a-b536-2ef4731d9dad" },
          "data": { "type": "company", "id": "2a15e462-7710-332a-b536-2ef4731d9dad" }
        }
      },
      "links": { "self": "/v1.1/ship/33416c8a-3cd0-3b84-b92e-e63a071fa28f" }
    },
    {
      "type": "itinerary",
      "id": "028a4d84-d017-328a-b6ca-f5d6fe76ee7e",
      "attributes": {
        "code": "07M869",
        "adult_age": 18,
        "child_age": 12,
        "title": "Croazieră în Italia, Grecia si Turcia",
        "nights": 7,
        "hero_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/croaziere-in-mediterana-italia-roma-coloseum-hero-1920x800-il-cel-02.jpg",
        "thumb_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/croaziere-in-mediterana-italia-roma-coloseum-thumb-900x900-il-cel-01.jpg",
        "include_url": "https://rccl.ro/ce-include-tariful-croazierei/royal-caribbean",
        "earliest_departure": "2027-05-09",
        "roundtrip": true
      },
      "relationships": {
        "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/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" }
        },
        "port": {
          "data": [
            { "type": "port", "id": "2ab3e8c8-b158-3343-bc7f-8aae9d9dfa6b" },
            { "type": "port", "id": "58e0a980-7b9d-373b-88a0-65d2d71f9fc8" },
            { "type": "port", "id": "1180214a-aa47-3661-92de-d5bf02abc75b" },
            { "type": "port", "id": "5784856a-7703-39e8-85b5-9f7a6e262643" },
            { "type": "port", "id": "6d6f95d0-8962-3559-8deb-68c746675543" },
            { "type": "port", "id": "2ab3e8c8-b158-3343-bc7f-8aae9d9dfa6b" }
          ]
        }
      },
      "links": { "self": "/v1.1/itinerary/028a4d84-d017-328a-b6ca-f5d6fe76ee7e" }
    },
    {
      "type": "region",
      "id": "9fd3aeee-3f27-3f2d-bf31-8fdb82141d1b",
      "attributes": {
        "code": "EUROP",
        "title": "Europa",
        "image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/croaziere-in-mediterana-grecia-santorini-thumb-900x900-dropbox-rci-02.jpg"
      },
      "links": { "self": "/v1.1/region/9fd3aeee-3f27-3f2d-bf31-8fdb82141d1b" }
    },
    {
      "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": "port",
      "id": "2ab3e8c8-b158-3343-bc7f-8aae9d9dfa6b",
      "attributes": {
        "code": "ROM",
        "title": "Roma (Civitavecchia), Italia",
        "description": "...",
        "url": "https://rccl.ro/porturi-croaziera/roma-civitavecchia-italia",
        "image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/croaziere-in-mediterana-italia-roma-coloseum-thumb-900x900-il-cel-01.jpg",
        "latitude": 42.101265,
        "longitude": 11.777715
      },
      "links": { "self": "/v1.1/port/2ab3e8c8-b158-3343-bc7f-8aae9d9dfa6b" }
    },
    {
      "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" }
    },
    {
      "type": "promotion_category",
      "id": "e36e47fc-fbad-39e3-b7f3-319acb891855",
      "attributes": {
        "code": "CD381350",
        "description": "BOGO60 NRD"
      },
      "relationships": {
        "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" }
        }
      },
      "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" }
    },
    {
      "type": "stateroom_subcategory",
      "id": "5ddb769e-2969-3ae0-baac-41259e1ee3d9",
      "attributes": {
        "code": "WS",
        "color": "000000",
        "title": "Apartament garantat",
        "description": "...",
        "image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/2019/03/QN_Cabina_J3.jpg"
      },
      "relationships": {
        "ship": {
          "links": { "related": "/v1.1/ship/33416c8a-3cd0-3b84-b92e-e63a071fa28f" },
          "data": { "type": "ship", "id": "33416c8a-3cd0-3b84-b92e-e63a071fa28f" }
        },
        "facility": {
          "links": { "related": "/v1.1/facility/7d436771-4de5-37cc-8fb7-a12cd76b5a10" },
          "data": { "type": "facility", "id": "7d436771-4de5-37cc-8fb7-a12cd76b5a10" }
        }
      },
      "links": { "self": "/v1.1/stateroom_subcategory/5ddb769e-2969-3ae0-baac-41259e1ee3d9" }
    },
    {
      "type": "facility",
      "id": "7d436771-4de5-37cc-8fb7-a12cd76b5a10",
      "attributes": {
        "title": "ROYAL CARIBBEAN INTERNATIONAL - APARTAMENTE CLASA SEA",
        "description": "..."
      },
      "relationships": {
        "company": {
          "links": { "related": "/v1.1/company/2a15e462-7710-332a-b536-2ef4731d9dad" },
          "data": { "type": "company", "id": "2a15e462-7710-332a-b536-2ef4731d9dad" }
        }
      },
      "links": { "self": "/v1.1/facility/7d436771-4de5-37cc-8fb7-a12cd76b5a10" }
    }
  ],
  "jsonapi": {
    "version": "1.0"
  }
}

Sailing Attributes

Field	Type	Description
`departure`	string	Departure date (ISO 8601)
`amount`	float	Starting price
`title`	string	Sailing/itinerary title
`nights`	integer	Number of nights
`ports`	string[]	List of port names visited
`thumb_url`	string	Thumbnail image URL

Relationships

Relationship	Type	Cardinality	Description
`fare`	`fare`	many	All available fare options
`lowest_fare`	`fare`	one	The cheapest fare for this sailing
`company`	`company`	one	Operating cruise line
`region`	`region`	one	Sailing region
`port`	`port`	many	Ports of call
`itinerary`	`itinerary`	one	Itinerary details
`stateroom_supracategory`	`stateroom_supracategory`	many	Available stateroom types
`ship`	`ship`	one	Ship operating this sailing

Included Resource Types

The response eagerly loads all related resources in the included array:

Type	Key Attributes
`company`	`code`, `title`, `logo_url`, `gratuities_included`
`ship`	`code`, `title`, `capacity`, `crew`, `decks`
`itinerary`	`code`, `title`, `nights`, `roundtrip`, `earliest_departure`
`region`	`code`, `title`, `image_url`
`port`	`code`, `title`, `latitude`, `longitude`
`fare`	`amount`, `passenger_1_amount`, `passenger_2_amount`, taxes
`stateroom_supracategory`	`code`, `title`
`stateroom_subcategory`	`code`, `title`, `surface_area`, `balcony_area`
`stateroom_category`	`title`, `description`, `image_url`
`promotion_category`	`code`, `description`, `displayed_description`
`refundability`	`code`, `description`
`facility`	`title`, `description`

Error Responses

Status	Description
`401`	Unauthorized — missing or invalid API key
`500`	Internal Server Error — upstream query failure

Request​

Query Parameters​

Pagination​

Sorting​

Filters​

Example Request​

Response​

200 OK​

Sailing Attributes​

Relationships​

Included Resource Types​

Error Responses​