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 value: "smedjan"
  • limit
    integer

    The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.

    Example value: 10Default value: 20Range: 0 - 50
  • 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.

    Example value: 5Default value: 0

Response

A paged set of playlists

  • href
    string
    Required

    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"
  • limit
    integer
    Required

    The maximum number of items in the response (as set in the query or by default).

    Example value: 20
  • next
    string
    Required
    Nullable

    URL to the next page of items. ( null if none)

    Example value: "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 value: 0
  • previous
    string
    Required
    Nullable

    URL to the previous page of items. ( null if none)

    Example value: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
  • total
    integer
    Required

    The total number of items available to return.

    Example value: 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.

    • name
      string

      The name of the playlist.

    • The user who owns the playlist

    • public
      boolean

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

    • type
      string

      The object type: "playlist"

    • uri
      string

      The Spotify URI for the playlist.