GET /v1.1/special_service/:id
Returns a single special service by its ID, with related company data included. Special services represent add-on items such as onboard credits or other booking extras.
Request
GET /v1.1/special_service/:id
URL Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The special service ID |
Example Request
curl -X GET "https://api.rccl.ro/v1.1/special_service/d7a1b2c3-4e5f-3678-9abc-def012345678" \
-H "X-WorldTravel-ApiKey: YOUR_API_KEY"
Response
200 OK
Returns a single special service resource with related company included.
Response body:
{
"data": {
"type": "special_service",
"id": "d7a1b2c3-4e5f-3678-9abc-def012345678",
"attributes": {
"code": "100OBC",
"remark": "CREDIT",
"description": "$100 OBC"
},
"relationships": {
"company": {
"links": {
"related": "/v1.1/company/2a15e462-7710-332a-b536-2ef4731d9dad"
},
"data": {
"type": "company",
"id": "2a15e462-7710-332a-b536-2ef4731d9dad"
}
}
},
"links": {
"self": "/v1.1/special_service/d7a1b2c3-4e5f-3678-9abc-def012345678"
}
},
"links": {
"self": "/v1.1/special_service/d7a1b2c3-4e5f-3678-9abc-def012345678"
},
"included": [
{
"type": "company",
"id": "2a15e462-7710-332a-b536-2ef4731d9dad",
"attributes": {
"code": "RCC",
"title": "Royal Caribbean International\u00ae",
"description": "..."
},
"links": {
"self": "/v1.1/company/2a15e462-7710-332a-b536-2ef4731d9dad"
}
}
],
"jsonapi": {
"version": "1.0"
}
}
Special Service Attributes
| Field | Type | Description |
|---|---|---|
code | string | Special service code |
remark | string | Service remark/category |
description | string | Human-readable description |
Relationships
| Relationship | Type | Cardinality | Description |
|---|---|---|---|
company | company | one | Operating cruise line |
Included Resource Types
| Type | Description |
|---|---|
company | Cruise line details |
Error Responses
| Status | Description |
|---|---|
401 | Unauthorized — missing or invalid API key |
500 | Internal Server Error — special service not found or upstream query failure |