Skip to the content
Get an API key
  1. API reference
  2. Read and write a user's library

Get playlist items

GET/api/{integrationUserUUID}/playlists/{playlistId}/items
CoreAuthBasicDevTokenDocsSessionToken

This endpoint fetches playlist items from Music Service.

Path parameters

integrationUserUUID
uuidrequired

The connected user: the integrationUserUUID from the sign-in callback.

playlistId
stringrequired

ID of the playlist

Query parameters

nextParam
string

Parameter returned in the response responsible for pagination.

limitParam
number

Specifies the maximum number of results per request, adjusted based on the limitations of the respective music service. Ignored if the service doesn't support such a limit.

Response

200application/json · TracksResponseok
results
Track[]
required
results[].id
string
required
results[].entryId
string | null
requiredIdentifier associated with a tracks within a specific collection. It is used to identify a particular instance of a track within a playlist or a user's library. Track entry id can be obtained during fetching playlist items or user's library.
results[].name
string
required
results[].isrc
string | null
required
results[].duration
number | null
required
results[].imageUrl
string | null
required
results[].previewUrl
string | null
required
results[].album
object | null
required
results[].album.name
string
required
results[].album.id
string | null
required
results[].album.totalItems
number | null
required
results[].album.artists
ArtistSimplified[] | null
required
results[].album.artists.id
string | null
required
results[].album.artists.entryId
string | null
requiredIdentifier associated with an artist within a user's library. Artist entry id can be obtained during fetching artists from user's library.
results[].album.artists.name
string
required
results[].album.artists.imageUrl
string | null
required
results[].album.artists.followers
number | null
required
results[].artists
ArtistSimplified[] | null
required
results[].artists.id
string | null
required
results[].artists.entryId
string | null
requiredIdentifier associated with an artist within a user's library. Artist entry id can be obtained during fetching artists from user's library.
results[].artists.name
string
required
results[].artists.imageUrl
string | null
required
results[].artists.followers
number | null
required
results[].isAvailable
boolean | null
Indicates whether the track is currently available for playback on the music service. For Spotify: false for local files or greyed-out tracks (copyright lost), true for playable tracks, null when unknown.
results[].dateAdded
string | null
nextParam
string | null
required
totalItems
number | null
required
Example answer
{
  "results": [
    {
      "id": "2nLtzopw4rPReszdYBJU6h",
      "entryId": "2nLtzopw4rPReszdYBJU6h",
      "name": "Numb",
      "isrc": "USWB10300474",
      "duration": 185586,
      "imageUrl": "https://i.scdn.co/image/ab67616d0000b273b4ad7ebaf4575f120eb3f193",
      "previewUrl": "https://p.scdn.co/mp3-preview/15e1178c9eb7f626ac1112ad8f56eccbec2cd6e5?cid=d3a370919fbb4853a2c037d9d92da680",
      "album": null,
      "artists": [
        null
      ],
      "isAvailable": true,
      "dateAdded": "2024-10-16T07:52:07.000Z"
    }
  ],
  "nextParam": "eyJvZmZzZXQiOjEwfQ==",
  "totalItems": 25
}

Errors

404

Your account has no connected user with this uuid, or the item does not exist.

412

The user must sign in again (IntegrationUserNotAuthenticated).

429

Too many requests. Wait for the seconds in Retry-After.