GET /v1.1/title/:id
Returns a single title by its ID, with related gender data included.
Request
GET /v1.1/title/:id
URL Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The title ID |
Example Request
curl -X GET "https://api.rccl.ro/v1.1/title/1553efac-04c2-329d-8bb6-1a0a4552a34e" \
-H "X-WorldTravel-ApiKey: YOUR_API_KEY"
Response
200 OK
Returns a single title resource with related objects included.
Response body:
{
"data": {
"type": "title",
"id": "1553efac-04c2-329d-8bb6-1a0a4552a34e",
"attributes": {
"code": "MRS",
"description": "Dna"
},
"relationships": {
"gender": {
"links": {
"related": "/v1.1/gender/80061894-3025-315f-869e-4e1f09471012"
},
"data": {
"type": "gender",
"id": "80061894-3025-315f-869e-4e1f09471012"
}
}
},
"links": {
"self": "/v1.1/title/1553efac-04c2-329d-8bb6-1a0a4552a34e"
}
},
"links": {
"self": "/v1.1/title/1553efac-04c2-329d-8bb6-1a0a4552a34e"
},
"included": [
{
"type": "gender",
"id": "80061894-3025-315f-869e-4e1f09471012",
"attributes": {
"code": "F",
"long_code": "Female",
"description": "Feminin"
},
"links": {
"self": "/v1.1/gender/80061894-3025-315f-869e-4e1f09471012"
}
}
],
"jsonapi": {
"version": "1.0"
}
}
Title Attributes
| Field | Type | Description |
|---|---|---|
code | string | Title code (e.g. MR, MRS) |
description | string | Title label |
Relationships
| Relationship | Type | Description |
|---|---|---|
gender | gender | The gender associated with this title |
Included Resources
The response includes related gender objects.
Error Responses
| Status | Description |
|---|---|
401 | Unauthorized — missing or invalid API key |
500 | Internal Server Error — title not found or upstream query failure |