Retrieve a participant type
GET/v2/experiences/{experienceId}/participant-types/{participantTypeId}
Requires your API key in the X-API-Key header.
Returns a single active participant type by id, including its computed isEnabledOnBookableOptions flag. Soft-deleted types and types of other experiences return 404.
curl "https://api.turneo.co/v2/experiences/8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f/participant-types/a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44" \
-H "X-API-Key: <your-api-key>"Path parameters
experienceIdstring (uuid)requiredUUID of the parent experience.
- Example:
8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
participantTypeIdstring (uuid)requiredUUID of the participant type (must belong to the experience in the path).
- Example:
a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44
Query parameters
languagestringTwo-letter language code. When present, multilingual fields collapse from full language objects to plain strings in that language.
- Example:
de
Responses
200object
The participant type.
idstring (uuid)Participant type id.
- Example:
a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44
experienceIdstring (uuid)read-onlyThe parent experience id.
- Example:
8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
namemap of stringnullableMultilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the
languagequery parameter is used.descriptionmap of stringnullableMultilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the
languagequery parameter is used.minAgeintegernullableMinimum age (inclusive), or null when unbounded.
- Example:
18
maxAgeintegernullableMaximum age (inclusive), or null when unbounded.
capacityExemptbooleanWhen true, participants of this type (e.g. infants) do not count toward slot or variant capacity.
- Example:
false
sortOrderintegerDisplay position (ascending).
- Example:
0
isDefaultbooleanTrue for the seeded Adult/Child/Infant types. Default types cannot be deleted and only their age range can be edited.
- Example:
true
externalIdstringnullableExternal provider identifier when synced from Bokun/Regiondo/Kompas.
isEnabledOnBookableOptionsbooleanread-onlyComputed: true when at least one ACTIVE, non-custom option of the experience enables this type AND has a future bookable availability slot — i.e. a guest could actually book it right now.
- Example:
true
{
"id": "a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44",
"experienceId": "8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f",
"name": {
"en": "Shared boat tour",
"de": "Gemeinsame Bootstour"
},
"description": {
"en": "Shared boat tour",
"de": "Gemeinsame Bootstour"
},
"minAge": 18,
"maxAge": null,
"capacityExempt": false,
"sortOrder": 0,
"isDefault": true,
"externalId": null,
"isEnabledOnBookableOptions": true
}Errors
- 401
Missing or invalid
X-API-Keyheader.- 404
The resource does not exist or belongs to another partner (existence is not leaked across partners).
Error body
typestringError class.
- Allowed values:
validation_errorclient_errorserver_error- Example:
validation_error
errorsobject[]Child fields
codestringMachine-readable error code.
- Example:
required
fieldstringnullableOffending field, or null/'general' for non-field errors.
- Example:
startTime
messagestringHuman-readable message.
- Example:
This field is required.
{
"type": "validation_error",
"errors": [
{
"code": "required",
"field": "startTime",
"message": "This field is required."
}
]
}