API Reference
Playlists
Retrieve a playlist

Retrieve a playlist

Return the full detail object for one playlist. Includes total item count, total duration, and collaborator list.

GET/api/v4/me/playlists/{slug}/

Path parameters

ParameterDescription
slugThe playlist slug, returned in every list response.

Example request

curl https://api.slipstreammusic.com/api/v4/me/playlists/late-night/ \
  -H "Authorization: Bearer $PARTNER_API_KEY"

Example response

{
  "id": "8a4b2c1d-9e7f-4a6b-b3c2-1f8d4e5a7c6b",
  "name": "Late Night",
  "slug": "late-night",
  "description": "Reflective jazz under 120 BPM",
  "owner": {
    "id": "1e2d3c4b-5a69-4f78-9012-345678abcdef",
    "username": "user-12345",
    "name": "Sam Editor"
  },
  "permission": "owner",
  "playlist_type": "user",
  "tracks": 12,
  "duration": 2814,
  "url": "/playlists/late-night",
  "blurhash": "L6PZfSi_.AyE_3t7t7R**0o#DgR4",
  "all_image_sizes": {
    "small":  "https://...",
    "medium": "https://...",
    "large":  "https://..."
  },
  "collaborators": [
    {
      "id": "...",
      "username": "...",
      "permission": "can_edit"
    }
  ]
}

See The Playlist object for the field reference.

Listing the tracks inside

This endpoint returns the playlist's metadata, not its items. To get the tracks, use:

curl "https://api.slipstreammusic.com/api/v4/en/tracks/?user_playlist=late-night&limit=50" \
  -H "Authorization: Bearer $PARTNER_API_KEY"

The response is a paginated list of Track objects, in playlist order.