API reference

List playlists

Returns the playlists your client is allowed to access, paginated.

GET/v1/playlists

scopecatalog:read

Query parameters

pageintegeroptionaldefault 1
Page number.
pageSizeintegeroptionaldefault 20
Items per page (max 100).

Request

GET /v1/playlists

curl "https://<your-b2b-host>/v1/playlists?page=1&pageSize=20" \
  -H "Authorization: Bearer $TOKEN"

Response

Playlist type is one of CURATED or CUSTOM. Use the playlist id to fetch its tracks.

{
  "data": {
    "totalRecords": 24,
    "totalPages": 2,
    "currentPage": 1,
    "pageSize": 20,
    "items": [
      {
        "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	insufficient_scope	Token lacks catalog:read.

PreviousTop tracks Next Get a playlist