Skip to main content

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

ParameterTypeRequiredDescription
idstringYesThe 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

FieldTypeDescription
codestringTitle code (e.g. MR, MRS)
descriptionstringTitle label

Relationships

RelationshipTypeDescription
gendergenderThe gender associated with this title

Included Resources

The response includes related gender objects.

Error Responses

StatusDescription
401Unauthorized — missing or invalid API key
500Internal Server Error — title not found or upstream query failure