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.

Requestbash
curl "https://api.turneo.co/v2/experiences/available-filters" \
  -H "X-API-Key: <your-api-key>"

Query parameters

  • statusstring

    Same as on the list endpoint; excluded from the status facet's own counts.

    Example:
    ACTIVE
  • locationstring

    Same as on the list endpoint; excluded from the locations facet's own counts.

    Example:
    Paris
  • categoriesstring

    Same as on the list endpoint; excluded from the categories facet's own counts.

    Example:
    Day trips
  • searchstring

    Free-text search, applied to every facet.

    Example:
    kayak

Responses

200object

Facet counts.

  • statusobject

    Experience counts per status. Always contains all three keys, zero-filled.

    Child fields
    • ACTIVEinteger

      Number of ACTIVE experiences.

      Example:
      12
    • INACTIVEinteger

      Number of INACTIVE experiences.

      Example:
      3
    • DRAFTinteger

      Number of DRAFT experiences.

      Example:
      5
  • categoriesmap of integer

    Experience counts keyed by category type. Only non-empty categories appear.

  • locationsmap of integer

    Experience counts keyed by location city. Only non-empty cities appear.

  • organizersmap of object

    Per-organizer counts keyed by organizer partner ID.

    Child fields
    • namestring

      Organizer display name.

      Example:
      Acme Tours
    • countinteger

      Number of matching experiences by this organizer.

      Example:
      6
Response 200json
{
  "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[].field and errors[].code.

Error body
  • typestring

    Error class.

    Allowed values:
    validation_errorclient_errorserver_error
    Example:
    validation_error
  • errorsobject[]
    Child fields
    • codestring

      Machine-readable error code.

      Example:
      required
    • fieldstringnullable

      Offending field, or null/'general' for non-field errors.

      Example:
      startTime
    • messagestring

      Human-readable message.

      Example:
      This field is required.
Response 400json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}