Get a list of the playlists owned or followed by a Spotify user.

Endpoint

GET https://api.spotify.com/v1/users/{user_id}/playlists

Request Parameters

Path parameter
Value
user_id
The user's Spotify user ID.

Header field
Value
Authorization
Required. A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details.

Private playlists are only retrievable for the current user and requires the playlist-read-private scope to have been authorized by the user. Note that this scope alone will not return collaborative playlists, even though they are always private.

Collaborative playlists are only retrievable for the current user and requires the playlist-read-collaborative scope to have been authorized by the user.

Query parameter
Value
limit
Optional. The maximum number of playlists to return. Default: 20. Minimum: 1. Maximum: 50.
offset
Optional. The index of the first playlist to return. Default: 0 (the first object). Use with limit to get the next set of playlists.

Response Format

On success, the HTTP status code in the response header is 200 OK and the response body contains an array of simplified playlist objects (wrapped in a paging object) in JSON format. On error, the header status code is an error code and the response body contains an error object.

Example

curl -X GET "https://api.spotify.com/v1/users/wizzler/playlists" -H "Authorization: Bearer {your access token}"
{
  "href": "https://api.spotify.com/v1/users/wizzler/playlists",
  "items": [ {
    "collaborative": false,
    "external_urls": {
      "spotify": "http://open.spotify.com/user/wizzler/playlists/53Y8wT46QIMz5H4WQ8O22c"
    },
    "href": "https://api.spotify.com/v1/users/wizzler/playlists/53Y8wT46QIMz5H4WQ8O22c",
    "id": "53Y8wT46QIMz5H4WQ8O22c",
    "images" : [ ],
    "name": "Wizzlers Big Playlist",
    "owner": {
      "external_urls": {
        "spotify": "http://open.spotify.com/user/wizzler"
      },
      "href": "https://api.spotify.com/v1/users/wizzler",
      "id": "wizzler",
      "type": "user",
      "uri": "spotify:user:wizzler"
    },
    "public": true,
    "snapshot_id" : "bNLWdmhh+HDsbHzhckXeDC0uyKyg4FjPI/KEsKjAE526usnz2LxwgyBoMShVL+z+",
    "tracks": {
      "href": "https://api.spotify.com/v1/users/wizzler/playlists/53Y8wT46QIMz5H4WQ8O22c/tracks",
      "total": 30
    },
    "type": "playlist",
    "uri": "spotify:user:wizzler:playlist:53Y8wT46QIMz5H4WQ8O22c"
  }, {
    "collaborative": false,
    "external_urls": {
      "spotify": "http://open.spotify.com/user/wizzlersmate/playlists/1AVZz0mBuGbCEoNRQdYQju"
    },
    "href": "https://api.spotify.com/v1/users/wizzlersmate/playlists/1AVZz0mBuGbCEoNRQdYQju",
    "id": "1AVZz0mBuGbCEoNRQdYQju",
    "images" : [ ],
    "name": "Another Playlist",
    "owner": {
      "external_urls": {
        "spotify": "http://open.spotify.com/user/wizzlersmate"
      },
      "href": "https://api.spotify.com/v1/users/wizzlersmate",
      "id": "wizzlersmate",
      "type": "user",
      "uri": "spotify:user:wizzlersmate"
    },
    "public": true,
    "snapshot_id" : "Y0qg/IT5T02DKpw4uQKc/9RUrqQJ07hbTKyEeDRPOo9LU0g0icBrIXwVkHfQZ/aD",
    "tracks": {
      "href": "https://api.spotify.com/v1/users/wizzlersmate/playlists/1AVZz0mBuGbCEoNRQdYQju/tracks",
      "total": 58
    },
    "type": "playlist",
    "uri": "spotify:user:wizzlersmate:playlist:1AVZz0mBuGbCEoNRQdYQju"
...
  } ],
  "limit": 9,
  "next": null,
  "offset": 0,
  "previous": null,
  "total": 9
}

Try it in our Web API Console

playlist object (simplified)

Key
Value Type
Value Description
collaborative
Booleantrue if the owner allows other users to modify the playlist.
external_urlsan external URL object Known external URLs for this playlist.
hrefstringA link to the Web API endpoint providing full details of the playlist.
id
string
The Spotify ID for the playlist.
imagesan array of image objectsImages for the playlist. The array may be empty or contain up to three images. The images are returned by size in descending order. See Working with Playlists.

Note: If returned, the source URL for the image (url) is temporary and will expire in less than a day.
name
string
The name of the playlist.
owner
a user objectThe user who owns the playlist
public
Boolean or nullThe playlist's public/private status: true the playlist is public, false the playlist is private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists.
snapshot_idstringThe version identifier for the current playlist. Can be supplied in other requests to target a specific playlist version
tracksa tracks objectA collection containing a link (href) to the Web API endpoint where full details of the playlist's tracks can be retrieved, along with the total number of tracks in the playlist.
type
string
The object type: "playlist"
uristringThe Spotify URI for the playlist.

paging object

Key
Value Type
Value Description
hrefstringA link to the Web API endpoint returning the full result of the request.
itemsan array of objectsThe requested data.
limitintegerThe maximum number of items in the response (as set in the query or by default).
next
string
URL to the next page of items. (null if none)
offsetintegerThe offset of the items returned (as set in the query or by default).
previous
string
URL to the previous page of items. (null if none)
total
integer
The total number of items available to return.