List Music Categories

FreshGET

GET https://api.creatify.ai/api/music_categories/

Retrieve all available background music categories. Use these categories to browse and filter the music library.

Headers

Header	Type	Required	Description
X-API-ID	string	Yes	Your Creatify API ID
X-API-KEY	string	Yes	Your Creatify API key

Example Request

curl -X GET 'https://api.creatify.ai/api/music_categories/' \
  -H 'X-API-ID: your-api-id' \
  -H 'X-API-KEY: your-api-key'

Response

[
  {
    "id": "cat-001",
    "name": "Upbeat",
    "description": "Energetic and positive tracks"
  },
  {
    "id": "cat-002",
    "name": "Corporate",
    "description": "Professional background music"
  },
  {
    "id": "cat-003",
    "name": "Cinematic",
    "description": "Dramatic and emotional scores"
  },
  {
    "id": "cat-004",
    "name": "Ambient",
    "description": "Calm and atmospheric soundscapes"
  }
]

Response Fields

Field	Type	Description
id	string	Unique category identifier
name	string	Category name
description	string	Category description

Status Codes

Code	Description
200	Success
401	Unauthorized -- invalid API credentials
500	Internal server error