Skip to main content
GET
/
playlists
/
{id}
Get a Playlist
curl --request GET \
  --url https://open.beatpass.ca/api/v1/playlists/{id} \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "playlist": {
    "id": 123,
    "name": "Some Playlist",
    "public": true,
    "collaborative": false,
    "image": "https://example.com/image1.jpg",
    "description": "<string>",
    "totalDuration": 386493,
    "tracks": {
      "current_page": 1,
      "from": 1,
      "to": 100,
      "per_page": 25,
      "last_page": 156,
      "total": 264,
      "data": [
        {
          "id": 123,
          "name": "Hey Hey What Can I Do",
          "release_date": "1982-11-19",
          "image": "https://example.com/image1.jpg",
          "duration": 5645848548,
          "description": "<string>",
          "artists": [
            {
              "id": 123,
              "name": "Led Zeppelin",
              "image_small": "https://example.com/image1.jpg",
              "verified": true
            }
          ]
        }
      ]
    }
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

id
integer
required

ID of the playlist

Response

Response body contains a playlist object in JSON format.

status
string
Example:

"success"

playlist
object
Last modified on November 29, 2025