REMINDER : We are updating the criteria to be granted extended access to the Web API.
Submit your extended quota mode application by May 15th. For more information, read here.

Web API •References / Playlists / Get User's Playlists

Get User's Playlists

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

Authorization scopes

Request

user_id
string
Required
The user's Spotify user ID.
Example: smedjan
limit
integer
The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
Default: limit=20Range: 0 - 50Example: limit=10
offset
integer
The index of the first playlist to return. Default: 0 (the first object). Maximum offset: 100.000. Use with limit to get the next set of playlists.
Default: offset=0Example: offset=5

Response

A paged set of playlists

href
string
Required
A link to the Web API endpoint returning the full result of the request
Example: "https://api.spotify.com/v1/me/shows?offset=0&limit=20"
limit
integer
Required
The maximum number of items in the response (as set in the query or by default).
Example: 20
next
string
Required
Nullable
URL to the next page of items. ( null if none)
Example: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
offset
integer
Required
The offset of the items returned (as set in the query or by default)
Example: 0
previous
string
Required
Nullable
URL to the previous page of items. ( null if none)
Example: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
total
integer
Required
The total number of items available to return.
Example: 4
Required
- collaborative
  boolean
  true if the owner allows other users to modify the playlist.
- description
  string
  The playlist description. Only returned for modified, verified playlists, otherwise null.
- Known external URLs for this playlist.
  spotify
  string
  The Spotify URL for the object.
- href
  string
  A link to the Web API endpoint providing full details of the playlist.
- id
  string
  The Spotify ID for the playlist.
- Images 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.
  url
  string
  Required
  The source URL of the image.
  Example: "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228"
  height
  integer
  Required
  Nullable
  The image height in pixels.
  Example: 300
  width
  integer
  Required
  Nullable
  The image width in pixels.
  Example: 300
- name
  string
  The name of the playlist.
- The user who owns the playlist
  Known public external URLs for this user.
  spotify
  string
  The Spotify URL for the object.
  href
  string
  A link to the Web API endpoint for this user.
  id
  string
  The Spotify user ID for this user.
  type
  string
  The object type.
  Allowed values: "user"
  uri
  string
  The Spotify URI for this user.
  display_name
  string
  Nullable
  The name displayed on the user's profile. null if not available.
- public
  boolean
  The playlist's public/private status (if it is added to the user's profile): 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_id
  string
  The version identifier for the current playlist. Can be supplied in other requests to target a specific playlist version
- A 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. Note, a track object may be null. This can happen if a track is no longer available.
  href
  string
  A link to the Web API endpoint where full details of the playlist's tracks can be retrieved.
  total
  integer
  Number of tracks in the playlist.
- type
  string
  The object type: "playlist"
- uri
  string
  The Spotify URI for the playlist.

Response sample

{  "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20",  "limit": 20,  "next": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",  "offset": 0,  "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",  "total": 4,  "items": [    {      "collaborative": false,      "description": "string",      "external_urls": {        "spotify": "string"      },      "href": "string",      "id": "string",      "images": [        {          "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228",          "height": 300,          "width": 300        }      ],      "name": "string",      "owner": {        "external_urls": {          "spotify": "string"        },        "href": "string",        "id": "string",        "type": "user",        "uri": "string",        "display_name": "string"      },      "public": false,      "snapshot_id": "string",      "tracks": {        "href": "string",        "total": 0      },      "type": "string",      "uri": "string"    }  ]}