Facet counts for the experiences list
GET/v2/experiences/available-filters
Works without an API key; send X-API-Key to act as your partner account.
Returns per-facet counts (statuses, categories, locations, organizers) for the experiences the caller can see, for building filter UIs next to the list endpoint.
Accepts the same filter query parameters as GET /v2/experiences. Counts use
self-excluded semantics: when computing a facet's counts, that facet's own
filter is dropped from the request, so the caller sees the alternatives they could
switch to. Example: with ?status=ACTIVE, the status facet still reports the
DRAFT and INACTIVE counts. Pagination and sort parameters are ignored.
The status facet always contains the three keys ACTIVE, INACTIVE and DRAFT
(zero-filled); categories, locations and organizers only contain keys that
have at least one matching experience.
curl "https://api.turneo.co/v2/experiences/available-filters" \
-H "X-API-Key: <your-api-key>"Query parameters
statusstringSame as on the list endpoint; excluded from the
statusfacet's own counts.- Example:
ACTIVE
locationstringSame as on the list endpoint; excluded from the
locationsfacet's own counts.- Example:
Paris
categoriesstringSame as on the list endpoint; excluded from the
categoriesfacet's own counts.- Example:
Day trips
searchstringFree-text search, applied to every facet.
- Example:
kayak
Responses
200object
Facet counts.
statusobjectExperience counts per status. Always contains all three keys, zero-filled.
Child fields
ACTIVEintegerNumber of ACTIVE experiences.
- Example:
12
INACTIVEintegerNumber of INACTIVE experiences.
- Example:
3
DRAFTintegerNumber of DRAFT experiences.
- Example:
5
categoriesmap of integerExperience counts keyed by category type. Only non-empty categories appear.
locationsmap of integerExperience counts keyed by location city. Only non-empty cities appear.
organizersmap of objectPer-organizer counts keyed by organizer partner ID.
Child fields
namestringOrganizer display name.
- Example:
Acme Tours
countintegerNumber of matching experiences by this organizer.
- Example:
6
{
"status": {
"ACTIVE": 12,
"INACTIVE": 3,
"DRAFT": 5
},
"categories": {
"Day trips": 4,
"Dining": 2
},
"locations": {
"Paris": 7,
"Rome": 3
},
"organizers": {
"acme-tours": {
"name": "Acme Tours",
"count": 6
}
}
}Errors
- 400
Validation failed. Inspect
errors[].fieldanderrors[].code.
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."
}
]
}