Skip to content
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.

    • 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.

      • 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.

endpointhttps://api.spotify.com/v1/users/{user_id}/playlistsuser_idlimitoffset

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"    }  ]}