Distinct filter values for the caller's bookings
GET/v2/bookings/available-filters
Requires your API key in the X-API-Key header.
Returns the de-duplicated sets of experiences, stores, agent names, resellers and organizers that appear across the bookings visible to the caller — used to populate the bookings-page filter dropdowns. Honors the same query filters as the list endpoint, so the options can be narrowed to a filtered subset.
curl "https://api.turneo.co/v2/bookings/available-filters" \
-H "X-API-Key: <your-api-key>"Responses
200object
Distinct filter options.
experienceobject[]Experiences that appear in the caller's bookings.
Child fields
idstring (uuid)Experience UUID.
- Example:
9b2e6c7d-1f2a-4b3c-8d9e-0a1b2c3d4e5f
namestringExperience name in the booking's language.
- Example:
Split Old Town Walking Tour
storeobject[]Stores that appear in booking metadata.
Child fields
idstringStore ID.
- Example:
store-123
namestringStore display name ("" when unknown).
- Example:
Lobby Desk
agentNamestring[]Sorted distinct concierge agent names.
resellerobject[]Resellers that appear in the caller's bookings.
Child fields
idstringReseller partner ID.
- Example:
hotel-adriatic
namestringReseller name.
- Example:
Hotel Adriatic
organizerobject[]Organizers that appear in the caller's bookings.
Child fields
idstringOrganizer partner ID.
- Example:
split-tours
namestringOrganizer name.
- Example:
Split Tours
{
"experience": [
{
"id": "9b2e6c7d-1f2a-4b3c-8d9e-0a1b2c3d4e5f",
"name": "Split Old Town Walking Tour"
}
],
"store": [
{
"id": "store-123",
"name": "Lobby Desk"
}
],
"agentName": [
"Marta",
"Niko"
],
"reseller": [
{
"id": "hotel-adriatic",
"name": "Hotel Adriatic"
}
],
"organizer": [
{
"id": "split-tours",
"name": "Split Tours"
}
]
}Errors
- 400
Validation failed. Inspect
errors[].fieldanderrors[].code.- 401
Missing or invalid
X-API-Keyheader.- 403
The API key is valid but not allowed to perform this action on this resource.
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."
}
]
}