List activity feed filter facets

GET/v2/activities/available-filters

Requires your API key in the X-API-Key header.

Returns the category and actor values actually present in the caller's activity feed (not the full fixed vocabulary), each with its display label. A value absent from the caller's activity is simply omitted, so this endpoint also tells you which filters are worth showing at all.

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

Responses

200object

Returns the available filter facets.

  • categoryobject[]

    Categories present in the caller's activity, each with its display label.

    Child fields
    • valuestring
      Example:
      booking
    • labelstring
      Example:
      Booking
  • actorobject[]

    Actor types present in the caller's activity, each with its display label.

    Child fields
    • valuestring
      Example:
      guest
    • labelstring
      Example:
      Guest
Response 200json
{
  "category": [
    {
      "value": "booking",
      "label": "Booking"
    }
  ],
  "actor": [
    {
      "value": "guest",
      "label": "Guest"
    }
  ]
}

Errors

401

Missing or invalid X-API-Key header.

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 401json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}