API reference

Get a playlist

Fetch a single playlist's metadata by id.

GET/v1/playlists/:playlistId

scopecatalog:read

Path parameters

playlistIdstring (UUID)required
The playlist's unique id.

Request

GET /v1/playlists/:playlistId

curl "https://<your-b2b-host>/v1/playlists/p1a2b3c4-d5e6-7f80-9a1b-2c3d4e5f6a7b" \
  -H "Authorization: Bearer $TOKEN"

Response

{
  "data": {
    "id": "p1a2b3c4-d5e6-7f80-9a1b-2c3d4e5f6a7b",
    "code": "TOP-50",
    "name": "Top 50",
    "slug": "top-50",
    "description": "The 50 most-licensed tracks this month.",
    "type": "CURATED"
  },
  "error": { "code": 0, "message": "OK" }
}

Errors

HTTP	error.type	Meaning
401	invalid_token	Token missing, malformed or expired.
403	playlist_restricted	Your client isn't granted that playlist.
404	playlist_not_found	No playlist matches that id.

PreviousList playlists Next Playlist tracks