GET /v1.1/search/days
Returns a filtered list of itinerary days, i.e. the daily port schedule in the "Itinerariu" section below.
Need bulk data without rate limits?
Use /v1.1/files instead. It provides the same itinerary days as pre-built NDJSON exports via signed URLs — with no rate limits.
Request
GET /v1.1/search/days
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
filter[objects] | string | Yes | Filter expression to select itinerary days |
page[number] | integer | No | Page number (one-indexed, default 1) |
page[size] | integer | No | Items per page (default 10, max 1000) |
Example Request
curl -X GET "https://api.rccl.ro/v1.1/search/days?filter[objects]=..." \
-H "X-WorldTravel-ApiKey: YOUR_API_KEY"
Response
200 OK
Returns an array of itinerary day resources with related objects included.
Response body:
{
"data": [
{
"type": "itinerary_day",
"id": "cd2d8379-50de-396f-9083-0e44b0c737a6",
"attributes": {
"departure": "2028-01-05",
"day": "2028-01-05",
"departure_time": "16:00:00"
},
"relationships": {
"ship": {
"links": {
"related": "/v1.1/ship/aa85f184-0e28-3d8a-8304-dbc2c0d7c9b2"
},
"data": {
"type": "ship",
"id": "aa85f184-0e28-3d8a-8304-dbc2c0d7c9b2"
}
},
"itinerary": {
"links": {
"related": "/v1.1/itinerary/d017bbac-e0ea-3652-b7eb-5ef5bedfd426"
},
"data": {
"type": "itinerary",
"id": "d017bbac-e0ea-3652-b7eb-5ef5bedfd426"
}
},
"port": {
"links": {
"related": "/v1.1/port/29c47d99-0409-3b5a-8cdc-b68720ffd547"
},
"data": {
"type": "port",
"id": "29c47d99-0409-3b5a-8cdc-b68720ffd547"
}
},
"sailing_state": {
"links": {
"related": "/v1.1/sailing_state/f623e75a-f30e-32bb-973d-6df5b50bb7b5"
},
"data": {
"type": "sailing_state",
"id": "f623e75a-f30e-32bb-973d-6df5b50bb7b5"
}
}
},
"links": {
"self": "/v1.1/search/days/cd2d8379-50de-396f-9083-0e44b0c737a6"
}
},
{
"type": "itinerary_day",
"id": "36489e4a-3291-3584-b338-7662fe76a030",
"attributes": {
"departure": "2028-01-05",
"day": "2028-01-06"
},
"relationships": {
"ship": {
"links": {
"related": "/v1.1/ship/aa85f184-0e28-3d8a-8304-dbc2c0d7c9b2"
},
"data": {
"type": "ship",
"id": "aa85f184-0e28-3d8a-8304-dbc2c0d7c9b2"
}
},
"itinerary": {
"links": {
"related": "/v1.1/itinerary/d017bbac-e0ea-3652-b7eb-5ef5bedfd426"
},
"data": {
"type": "itinerary",
"id": "d017bbac-e0ea-3652-b7eb-5ef5bedfd426"
}
},
"sailing_state": {
"links": {
"related": "/v1.1/sailing_state/0d61f837-0cad-3d41-af80-b84d143e1257"
},
"data": {
"type": "sailing_state",
"id": "0d61f837-0cad-3d41-af80-b84d143e1257"
}
}
},
"links": {
"self": "/v1.1/search/days/36489e4a-3291-3584-b338-7662fe76a030"
}
}
],
"links": {
"self": "/v1.1/search/days",
"first": "/v1.1/search/days?page[number]=1&page[size]=10",
"next": "/v1.1/search/days?page[number]=2&page[size]=10"
},
"meta": {
"count": 6
},
"included": [
{
"type": "ship",
"id": "aa85f184-0e28-3d8a-8304-dbc2c0d7c9b2",
"attributes": {
"code": "OY",
"title": "Odyssey of the Seas",
"description": "..."
},
"links": {
"self": "/v1.1/ship/aa85f184-0e28-3d8a-8304-dbc2c0d7c9b2"
}
},
{
"type": "itinerary",
"id": "d017bbac-e0ea-3652-b7eb-5ef5bedfd426",
"attributes": {
"code": "280105-005",
"title": "Croazieră în Caraibele de Sud",
"nights": 5
},
"links": {
"self": "/v1.1/itinerary/d017bbac-e0ea-3652-b7eb-5ef5bedfd426"
}
},
{
"type": "port",
"id": "29c47d99-0409-3b5a-8cdc-b68720ffd547",
"attributes": {
"code": "FLL",
"title": "Fort Lauderdale (Port Everglades), Florida"
},
"links": {
"self": "/v1.1/port/29c47d99-0409-3b5a-8cdc-b68720ffd547"
}
},
{
"type": "sailing_state",
"id": "f623e75a-f30e-32bb-973d-6df5b50bb7b5",
"attributes": {
"code": "DEPARTURE",
"description": "Imbarcare"
},
"links": {
"self": "/v1.1/sailing_state/f623e75a-f30e-32bb-973d-6df5b50bb7b5"
}
},
{
"type": "sailing_state",
"id": "0d61f837-0cad-3d41-af80-b84d143e1257",
"attributes": {
"code": "AT_SEA",
"description": "Zi pe mare"
},
"links": {
"self": "/v1.1/sailing_state/0d61f837-0cad-3d41-af80-b84d143e1257"
}
}
],
"jsonapi": {
"version": "1.0"
}
}
Itinerary Day Attributes
| Field | Type | Description |
|---|---|---|
departure | string | Sailing departure date (ISO 8601) |
day | string | Date of this specific day (ISO 8601) |
departure_time | string | Departure time from port (HH:MM:SS), if applicable |
arrival_time | string | Arrival time at port (HH:MM:SS), if applicable |
Relationships
| Relationship | Type | Description |
|---|---|---|
ship | ship | The ship sailing this day |
itinerary | itinerary | The itinerary this day belongs to |
port | port | The port visited on this day (absent for sea days) |
sailing_state | sailing_state | The state for this day (e.g. departure, at sea, docked) |
Included Resources
The response includes related ship, itinerary, port, and sailing_state objects.
Error Responses
| Status | Description |
|---|---|
401 | Unauthorized — missing or invalid API key |
500 | Internal Server Error — upstream query failure |