Get User's Playlists
Get a list of the playlists owned or followed by a Spotify user.
Request
- user_idstringRequired
The user's Spotify user ID.
Example value:"smedjan"
- limitinteger
The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
Example value:10
Default value:20
Range:0
-50
- offsetinteger
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.Example value:5
Default value:0
Response
A paged set of playlists
- hrefstringRequired
A link to the Web API endpoint returning the full result of the request
Example value:"https://api.spotify.com/v1/me/shows?offset=0&limit=20"
- limitintegerRequired
The maximum number of items in the response (as set in the query or by default).
Example value:20
- nextstringRequiredNullable
URL to the next page of items. (
null
if none)Example value:"https://api.spotify.com/v1/me/shows?offset=1&limit=1"
- offsetintegerRequired
The offset of the items returned (as set in the query or by default)
Example value:0
- previousstringRequiredNullable
URL to the previous page of items. (
null
if none)Example value:"https://api.spotify.com/v1/me/shows?offset=1&limit=1"
- totalintegerRequired
The total number of items available to return.
Example value:4
- Required
- collaborativeboolean
true
if the owner allows other users to modify the playlist. - descriptionstring
The playlist description. Only returned for modified, verified playlists, otherwise
null
. Known external URLs for this playlist.
- hrefstring
A link to the Web API endpoint providing full details of the playlist.
- idstring
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.- namestring
The name of the playlist.
The user who owns the playlist
- publicboolean
The 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_idstring
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 thetotal
number of tracks in the playlist. Note, a track object may benull
. This can happen if a track is no longer available.- typestring
The object type: "playlist"
- uristring
The Spotify URI for the playlist.