GET /v1.1/promotion_category/:id

Returns a single promotion category by its ID, with related company and refundability data included.

Request

GET /v1.1/promotion_category/:id

URL Parameters

Parameter	Type	Required	Description
id	string	Yes	The promotion category ID

Example Request

curl -X GET "https://api.rccl.ro/v1.1/promotion_category/00624011-bcaa-3f03-b4de-b554b624d4a3" \
  -H "X-WorldTravel-ApiKey: YOUR_API_KEY"

Response

200 OK

Returns a single promotion category resource 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/00624011-bcaa-3f03-b4de-b554b624d4a3"
    },
    "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 — promotion category not found or upstream query failure