GET /v1.1/itinerary_day

Returns a paginated list of all itinerary days, with related ship, itinerary, port, and sailing state data included.

Request

GET /v1.1/itinerary_day

Query Parameters

Parameter	Type	Default	Description
page[number]	integer	1	Page number (one-indexed)
page[size]	integer	10	Items per page (max 1000)

Example Request

curl -X GET "https://api.rccl.ro/v1.1/itinerary_day?page[number]=1&page[size]=10" \
  -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/itinerary_day/cd2d8379-50de-396f-9083-0e44b0c737a6"
            }
        }
    ],
    "links": {
        "self": "/v1.1/itinerary_day",
        "first": "/v1.1/itinerary_day?page[number]=1&page[size]=10",
        "next": "/v1.1/itinerary_day?page[number]=2&page[size]=10"
    },
    "meta": {
        "count": 18542
    },
    "included": [
        {
            "type": "ship",
            "id": "aa85f184-0e28-3d8a-8304-dbc2c0d7c9b2",
            "attributes": {
                "code": "EN",
                "title": "Enchantment of the Seas",
                "description": "..."
            },
            "links": {
                "self": "/v1.1/ship/aa85f184-0e28-3d8a-8304-dbc2c0d7c9b2"
            }
        },
        {
            "type": "itinerary",
            "id": "d017bbac-e0ea-3652-b7eb-5ef5bedfd426",
            "attributes": {
                "code": "05W758",
                "title": "Croazier\u0103 \u00een Caraibele de Vest",
                "nights": 5
            },
            "links": {
                "self": "/v1.1/itinerary/d017bbac-e0ea-3652-b7eb-5ef5bedfd426"
            }
        },
        {
            "type": "port",
            "id": "29c47d99-0409-3b5a-8cdc-b68720ffd547",
            "attributes": {
                "code": "TPA",
                "title": "Tampa, Florida, SUA",
                "description": "..."
            },
            "links": {
                "self": "/v1.1/port/29c47d99-0409-3b5a-8cdc-b68720ffd547"
            }
        },
        {
            "type": "sailing_state",
            "id": "f623e75a-f30e-32bb-973d-6df5b50bb7b5",
            "attributes": {
                "code": "D",
                "description": "Andocat"
            },
            "links": {
                "self": "/v1.1/sailing_state/f623e75a-f30e-32bb-973d-6df5b50bb7b5"
            }
        }
    ],
    "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