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

Get user's playlists

GET/api/{integrationUserUUID}/playlists
CoreAuthBasicDevTokenDocsSessionToken

This endpoint fetches owned & followed playlists from Music Service. As Amazon & Boomplay return data in separate endpoints, we combine the data from 2 sources (owned & liked playlist). So don't expect proper sorting for those.

Path parameters

integrationUserUUID
uuidrequired

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

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 · PlaylistsResponseok
results
Playlist[]
required
results[].name
string
required
results[].id
string
required
results[].totalItems
number | null
required
results[].imageUrl
string | null
required
results[].dateAdded
string | null
results[].isOwner
boolean
required
nextParam
string | null
required
totalItems
number | null
required
Example answer
{
  "results": [
    {
      "name": "Viva Playlist",
      "id": "1",
      "totalItems": 25,
      "imageUrl": "https://www.example-image.com/978263478234",
      "dateAdded": "2024-10-16T07:52:07.000Z",
      "isOwner": true
    }
  ],
  "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.