GET /v1.1/value_add/:id
Returns a single value-add promotion by its ID, with related currency data included. Value adds represent onboard credits or other bonus incentives attached to a fare.
Request
GET /v1.1/value_add/:id
URL Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The value add ID |
Example Request
curl -X GET "https://api.rccl.ro/v1.1/value_add/d6ec61d6-70c4-319d-9f58-342f0ae63785" \
-H "X-WorldTravel-ApiKey: YOUR_API_KEY"
Response
200 OK
Returns a single value add resource with related currency included.
Response body:
{
"data": {
"type": "value_add",
"id": "d6ec61d6-70c4-319d-9f58-342f0ae63785",
"attributes": {
"amount": 50
},
"relationships": {
"currency": {
"links": {
"related": "/v1.1/currency/3518f894-4d42-312d-937d-affe097d216e"
},
"data": {
"type": "currency",
"id": "3518f894-4d42-312d-937d-affe097d216e"
}
}
},
"links": {
"self": "/v1.1/value_add/d6ec61d6-70c4-319d-9f58-342f0ae63785"
}
},
"links": {
"self": "/v1.1/value_add/d6ec61d6-70c4-319d-9f58-342f0ae63785"
},
"included": [
{
"type": "currency",
"id": "3518f894-4d42-312d-937d-affe097d216e",
"attributes": {
"code": "USD",
"symbol": "$"
},
"links": {
"self": "/v1.1/currency/3518f894-4d42-312d-937d-affe097d216e"
}
}
],
"jsonapi": {
"version": "1.0"
}
}
Value Add Attributes
| Field | Type | Description |
|---|---|---|
amount | number | Value-add credit amount |
Relationships
| Relationship | Type | Cardinality | Description |
|---|---|---|---|
currency | currency | one | The currency for the value-add amount |
Included Resource Types
| Type | Description |
|---|---|
currency | Currency code and symbol |
Error Responses
| Status | Description |
|---|---|
401 | Unauthorized — missing or invalid API key |
500 | Internal Server Error — value add not found or upstream query failure |