Skip to main content
GET
/
categories
List categories
curl --request GET \
  --url https://www.wavmaker.com/api/v1/categories \
  --header 'Authorization: Bearer <token>'
{
  "page": 1,
  "pages": 4,
  "page_size": 20,
  "total": 77,
  "hits": [
    {
      "id": "80s-pop",
      "type": "genre",
      "name": "80s Pop"
    },
    {
      "id": "acoustic",
      "type": "genre",
      "name": "Acoustic"
    },
    {
      "id": "adult-contemporary",
      "type": "genre",
      "name": "Adult Contemporary"
    },
    {
      "id": "african",
      "type": "genre",
      "name": "African"
    },
    {
      "id": "alternative-hip-hop",
      "type": "genre",
      "name": "Alternative Hip Hop"
    },
    {
      "id": "alternative-r-b",
      "type": "genre",
      "name": "Alternative R&B"
    },
    {
      "id": "alternative-rock",
      "type": "genre",
      "name": "Alternative Rock"
    },
    {
      "id": "ambient",
      "type": "genre",
      "name": "Ambient"
    },
    {
      "id": "asian",
      "type": "genre",
      "name": "Asian"
    },
    {
      "id": "bluegrass",
      "type": "genre",
      "name": "Bluegrass"
    },
    {
      "id": "blues",
      "type": "genre",
      "name": "Blues"
    },
    {
      "id": "blues-rock",
      "type": "genre",
      "name": "Blues Rock"
    },
    {
      "id": "bossa-nova",
      "type": "genre",
      "name": "Bossa Nova"
    },
    {
      "id": "breakbeat",
      "type": "genre",
      "name": "Breakbeat"
    },
    {
      "id": "celtic",
      "type": "genre",
      "name": "Celtic"
    },
    {
      "id": "cinematic",
      "type": "genre",
      "name": "Cinematic"
    },
    {
      "id": "classical",
      "type": "genre",
      "name": "Classical"
    },
    {
      "id": "classic-rock",
      "type": "genre",
      "name": "Classic Rock"
    },
    {
      "id": "contemporary-pop",
      "type": "genre",
      "name": "Contemporary Pop"
    },
    {
      "id": "country",
      "type": "genre",
      "name": "Country"
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

type
enum<string>
Available options:
genre,
mood,
theme,
instrument
page
integer

The page number to return

limit
integer

The number of hits to return per page

Response

200 - application/json
page
integer
required

Current page number

pages
integer
required

Total number of pages

page_size
integer
required

Total number of hits per page

total
integer
required

Total number of hits

hits
object[]
required