---
title: "Allowed values for music descriptive parameters to be used in the searchAll endpoint."
method: GET
path: "/api/v1/allowedValues/musicalFeatures"
tags: ["allowed-values"]
---

# Allowed values for music descriptive parameters to be used in the searchAll endpoint.

`GET /api/v1/allowedValues/musicalFeatures`

## Query parameters

- `responseSize` 's' | 'l'
- `taxonomyVersion` 'v2_4'

## Response `200`

Retrieved searchFilters

- SearchFilterValuesDTO — Categories of musical features that can be used as search filters.
  - `primaryMoodCluster` string[], required
  - `secondaryMoodCluster` string[], required
  - `tertiaryMoodCluster` string[], required
  - `valence` string[], required
  - `arousal` string[], required
  - `pleasantness` string[], required
  - `engagement` string[], required
  - `vocals` string[], required
  - `dominantInstrument` string[], required
  - `secondaryInstrument` string[], required
  - `tertiaryInstrument` string[], required
  - `energy` string[], required
  - `soundGeneration` string[], required
  - `tempo` string[], required
  - `scale` string[], required
  - `key` string[], required
  - `rhythm` string[], required
  - `primarySoundCharacter` string[], required
  - `timbre` string[], required
  - `roughness` string[], required
  - `tonality` string[], required
  - `harmony` string[], required
  - `texture` string[], required
  - `groovyness` string[], required
  - `grooviness` string[], required
  - `space` string[], required
  - `loudness` string[], required
  - `productionRating` string[], required
  - `performanceRating` string[], required
  - `songRating` string[], required
  - `audienceAge` string[], required
  - `secondaryAudienceAge` string[], required
  - `tertiaryAudienceAge` string[], required
  - `audienceGender` string[], required
  - `audienceRegion` string[], required
  - `secondaryAudienceRegion` string[], required
  - `tertiaryAudienceRegion` string[], required
  - `originDecade` string[], required
  - `originRegion` string[], required
  - `languageOfPerformance` string[], required
  - `curateability` string[], required
  - `useCase` string[], required
  - `channelSuitability` string[], required
  - `pretzelStationSuitability` string[], required
  - `recordingEnvironment` string[], required
  - `content` string[], required
  - `moodPlayer` string[], required
  - `secondaryMoodPlayer` string[], required
  - `brandAttributes` string[], required

## Other responses

- `401` — Unauthorized
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/songtradr/apis/songtradr-api.md) · [All operations](https://skmtc.dev/songtradr/apis/songtradr-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/songtradr/songtradr-api/revisions/31c6f2d1e9a4/schema)