GET /v1.1/promotion_category

Returns a paginated list of all promotion categories, with related company and refundability data included.

Request

GET /v1.1/promotion_category

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

Response

200 OK

Returns an array of promotion category resources with related objects included.

Response body:

{
    "data": [
        {
            "type": "promotion_category",
            "id": "00624011-bcaa-3f03-b4de-b554b624d4a3",
            "attributes": {
                "code": "CF056023",
                "description": "BOGO60"
            },
            "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/e1e1d3d4-0573-327e-9ee0-480caf1283d6"
                    },
                    "data": {
                        "type": "refundability",
                        "id": "e1e1d3d4-0573-327e-9ee0-480caf1283d6"
                    }
                }
            },
            "links": {
                "self": "/v1.1/promotion_category/00624011-bcaa-3f03-b4de-b554b624d4a3"
            }
        }
    ],
    "links": {
        "self": "/v1.1/promotion_category",
        "first": "/v1.1/promotion_category?page[number]=1&page[size]=10",
        "next": "/v1.1/promotion_category?page[number]=2&page[size]=10"
    },
    "meta": {
        "count": 198
    },
    "included": [
        {
            "type": "company",
            "id": "2a15e462-7710-332a-b536-2ef4731d9dad",
            "attributes": {
                "code": "RCC",
                "title": "Royal Caribbean International®",
                "description": "..."
            },
            "links": {
                "self": "/v1.1/company/2a15e462-7710-332a-b536-2ef4731d9dad"
            }
        },
        {
            "type": "refundability",
            "id": "e1e1d3d4-0573-327e-9ee0-480caf1283d6",
            "attributes": {
                "code": "RF",
                "description": "Rambursabil"
            },
            "links": {
                "self": "/v1.1/refundability/e1e1d3d4-0573-327e-9ee0-480caf1283d6"
            }
        }
    ],
    "jsonapi": {
        "version": "1.0"
    }
}

Promotion Category Attributes

Field	Type	Description
code	string	Unique promotion category code
description	string	Promotion category description

Relationships

Relationship	Type	Description
company	company	The cruise line this promotion belongs to
refundability	refundability	The refundability policy for this promotion

Included Resources

The response includes related company and refundability objects.

Error Responses

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