API reference

Filter master list

Every available filter (genres, moods, use-cases…) grouped by type. Use this to build search UIs and dropdowns.

GET/v1/filters

scopecatalog:read

Query parameters

typeenumoptional
Optionally restrict to one group: genre, mood or usecase. Omit to get all groups.

Request

GET /v1/filters

curl "https://<your-b2b-host>/v1/filters?type=genre" \
  -H "Authorization: Bearer $TOKEN"

Response

Each filter has a stable id and slug — pass either to /v1/tracks (filterIds / filterSlugs) or /v1/search to filter the catalog.

{
  "data": {
    "genre": [
      { "id": "f1a2b3c4", "name": "Electronic", "slug": "electronic", "rank": 1 },
      { "id": "f1a2b3c5", "name": "Hip Hop",    "slug": "hip-hop",    "rank": 2 }
    ],
    "mood": [
      { "id": "f2b3c4d5", "name": "Energetic", "slug": "energetic", "rank": 1 }
    ],
    "usecase": [
      { "id": "f3c4d5e6", "name": "Advertising", "slug": "advertising", "rank": 1 }
    ]
  },
  "error": { "code": 0, "message": "OK" }
}

Errors

HTTP	error.type	Meaning
401	invalid_token	Token missing, malformed or expired.
403	insufficient_scope	Token lacks catalog:read.

PreviousPlaylist tracks Next Errors