List participant types of an experience
GET/v2/experiences/{experienceId}/participant-types
Requires your API key in the X-API-Key header.
Returns all active participant types of the experience, ordered by sortOrder. Reads are public to API-key callers. Every row carries the computed isEnabledOnBookableOptions flag: true only when at least one ACTIVE, non-custom option of the experience does not disable the type and has at least one future bookable availability slot — i.e. the type is actually purchasable right now. Use it to hide dead types from guest-facing pickers while still showing organizers the complete list.
curl "https://api.turneo.co/v2/experiences/8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f/participant-types" \
-H "X-API-Key: <your-api-key>"Path parameters
experienceIdstring (uuid)requiredUUID of the parent experience.
- Example:
8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
Query parameters
languagestringTwo-letter language code. When present, multilingual fields collapse from full language objects to plain strings in that language.
- Example:
de
pageintegerPage number (1-based).
- Default:
1- Example:
1
page_sizeintegerItems per page (default 50). Note the snake_case wire name.
- Default:
50- Example:
50
nopaginationbooleanSet to
trueto disable pagination and return the bare array of results.- Default:
false- Example:
false
Responses
200object
Paginated list of participant types.
countintegerTotal number of participant types.
- Example:
3
nextstringnullableAbsolute URL of the next page, or null on the last page.
previousstringnullableAbsolute URL of the previous page, or null on the first page.
resultsobject[]Participant types on this page, ordered by
sortOrder.Child fields
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
{
"count": 3,
"next": null,
"previous": null,
"results": [
{
"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.
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."
}
]
}