GET /v1.1/itinerary/:id

Returns a single itinerary by its ID, with related company, ship, region, and port data included.

Request

GET /v1.1/itinerary/:id

URL Parameters

Parameter	Type	Required	Description
id	string	Yes	The itinerary ID

Example Request

curl -X GET "https://api.rccl.ro/v1.1/itinerary/002712d0-f017-3c6a-beb9-c00a67f963ac" \
  -H "X-WorldTravel-ApiKey: YOUR_API_KEY"

Response

200 OK

Returns a single itinerary resource with related objects included.

Response body:

{
    "data": {
        "type": "itinerary",
        "id": "002712d0-f017-3c6a-beb9-c00a67f963ac",
        "attributes": {
            "code": "271220-016",
            "adult_age": 18,
            "child_age": 12,
            "title": "Croazieră în Noua Zeelanda, Tasmania si Australia",
            "nights": 16,
            "hero_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/croaziere-in-noua-zeelanda-milford-sound-fiorduri-1920x800-il-aza-01.jpg",
            "thumb_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/croaziere-in-noua-zeelanda-fiorduri-thumb-900x900-il-cel-03.jpg",
            "include_url": "https://rccl.ro/ce-include-tariful-croazierei/azamara",
            "earliest_departure": "2027-12-20"
        },
        "relationships": {
            "company": {
                "links": {
                    "related": "/v1.1/company/2edc9920-1ed8-3502-b31e-93d5ec6a94bd"
                },
                "data": {
                    "type": "company",
                    "id": "2edc9920-1ed8-3502-b31e-93d5ec6a94bd"
                }
            },
            "ship": {
                "links": {
                    "related": "/v1.1/ship/0fe75a51-89c2-3a3f-9236-21d098ddd03e"
                },
                "data": {
                    "type": "ship",
                    "id": "0fe75a51-89c2-3a3f-9236-21d098ddd03e"
                }
            },
            "region": {
                "links": {
                    "related": "/v1.1/region/48c53f1a-2b74-3166-9da2-29a60660b84d"
                },
                "data": {
                    "type": "region",
                    "id": "48c53f1a-2b74-3166-9da2-29a60660b84d"
                }
            },
            "port": {
                "data": [
                    {
                        "type": "port",
                        "id": "ef7f95de-bd78-3bfb-b1ed-799a2395b2f6"
                    },
                    {
                        "type": "port",
                        "id": "0c445f5c-8f99-3e08-8774-4f0a036c7521"
                    }
                ]
            }
        },
        "links": {
            "self": "/v1.1/itinerary/002712d0-f017-3c6a-beb9-c00a67f963ac"
        }
    },
    "links": {
        "self": "/v1.1/itinerary/002712d0-f017-3c6a-beb9-c00a67f963ac"
    },
    "included": [
        {
            "type": "company",
            "id": "2edc9920-1ed8-3502-b31e-93d5ec6a94bd",
            "attributes": {
                "code": "AZA",
                "title": "Azamara®",
                "description": "..."
            },
            "links": {
                "self": "/v1.1/company/2edc9920-1ed8-3502-b31e-93d5ec6a94bd"
            }
        },
        {
            "type": "ship",
            "id": "0fe75a51-89c2-3a3f-9236-21d098ddd03e",
            "attributes": {
                "code": "PR",
                "title": "Azamara Pursuit",
                "description": "..."
            },
            "links": {
                "self": "/v1.1/ship/0fe75a51-89c2-3a3f-9236-21d098ddd03e"
            }
        },
        {
            "type": "region",
            "id": "48c53f1a-2b74-3166-9da2-29a60660b84d",
            "attributes": {
                "title": "Australia si Noua Zeelanda"
            },
            "links": {
                "self": "/v1.1/region/48c53f1a-2b74-3166-9da2-29a60660b84d"
            }
        },
        {
            "type": "port",
            "id": "ef7f95de-bd78-3bfb-b1ed-799a2395b2f6",
            "attributes": {
                "code": "AKL",
                "title": "Auckland, Noua Zeelanda"
            },
            "links": {
                "self": "/v1.1/port/ef7f95de-bd78-3bfb-b1ed-799a2395b2f6"
            }
        }
    ],
    "jsonapi": {
        "version": "1.0"
    }
}

Itinerary Attributes

Field	Type	Description
code	string	Unique itinerary code
adult_age	integer	Minimum age considered adult
child_age	integer	Minimum age considered child
title	string	Itinerary title
nights	integer	Number of nights
hero_url	string	Hero image URL
thumb_url	string	Thumbnail image URL
include_url	string	URL describing what the fare includes
earliest_departure	string	Earliest departure date (ISO 8601)

Relationships

Relationship	Type	Description
company	company	The cruise line operating this itinerary
ship	ship	The ship sailing this itinerary
region	region	The geographic region of this itinerary
port	port[]	The ports visited on this itinerary

Included Resources

The response includes related company, ship, region, and port objects.

Error Responses

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