GET /v1.1/deck_image

Returns a paginated list of all deck images. Deck images are date-ranged variants of deck plans that may change depending on the year due to ship revitalizations.

Request

GET /v1.1/deck_image

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/deck_image?page[number]=1&page[size]=10" \
  -H "X-WorldTravel-ApiKey: YOUR_API_KEY"

Response

200 OK

Returns an array of deck image resources with related deck objects included.

Response body:

{
    "data": [
        {
            "type": "deck_image",
            "id": "000527a1-3f12-337c-bd34-616163afbc48",
            "attributes": {
                "since": "2021-05-09",
                "until": "2022-04-18",
                "image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/VI-Plan-punte-3-20220418.svg"
            },
            "relationships": {
                "deck": {
                    "links": {
                        "related": "/v1.1/deck/843b8d85-8dd3-3fea-8932-b5b911ea5e31"
                    },
                    "data": {
                        "type": "deck",
                        "id": "843b8d85-8dd3-3fea-8932-b5b911ea5e31"
                    }
                }
            },
            "links": {
                "self": "/v1.1/deck_image/000527a1-3f12-337c-bd34-616163afbc48"
            }
        },
        {
            "type": "deck_image",
            "id": "000c20cc-0ad2-3226-ae05-b8ceed104167",
            "attributes": {
                "since": "2022-05-14",
                "until": "2023-05-19",
                "image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/EC-Plan-punte-07-20230519.svg"
            },
            "relationships": {
                "deck": {
                    "links": {
                        "related": "/v1.1/deck/c96784bc-e8ab-3018-bbfd-d2fc11b6cb74"
                    },
                    "data": {
                        "type": "deck",
                        "id": "c96784bc-e8ab-3018-bbfd-d2fc11b6cb74"
                    }
                }
            },
            "links": {
                "self": "/v1.1/deck_image/000c20cc-0ad2-3226-ae05-b8ceed104167"
            }
        }
    ],
    "links": {
        "self": "/v1.1/deck_image",
        "first": "/v1.1/deck_image?page[number]=1&page[size]=10",
        "next": "/v1.1/deck_image?page[number]=2&page[size]=10"
    },
    "meta": {
        "count": 1872
    },
    "included": [
        {
            "type": "deck",
            "id": "843b8d85-8dd3-3fea-8932-b5b911ea5e31",
            "attributes": {
                "code": "03",
                "title": "Puntea 03",
                "number": 3,
                "image_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/VI-Plan-punte-3-20270430.svg",
                "legend_url": "https://ik.imagekit.io/worldtravel/wp-content/uploads/Legend-RCC.png"
            },
            "relationships": {
                "ship": {
                    "links": {
                        "related": "/v1.1/ship/8e8a2de2-6ec4-32bb-b0e3-edf3daab2f95"
                    },
                    "data": {
                        "type": "ship",
                        "id": "8e8a2de2-6ec4-32bb-b0e3-edf3daab2f95"
                    }
                }
            },
            "links": {
                "self": "/v1.1/deck/843b8d85-8dd3-3fea-8932-b5b911ea5e31"
            }
        }
    ],
    "jsonapi": {
        "version": "1.0"
    }
}

Deck Image Attributes

Field	Type	Description
since	string	Start date for this deck image version (ISO 8601)
until	string	End date for this deck image version (ISO 8601)
image_url	string	Deck plan image URL for this date range

Relationships

Relationship	Type	Description
deck	deck	The deck this image belongs to

Included Resources

The response includes related deck objects. See GET /v1.1/deck for deck attribute details.

Error Responses

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