Get User's Playlists

• hrefstring

  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"
• limitinteger

  Required

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

  Example: 20
• nextstring

  Required

  Nullable

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

  Example: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
• offsetinteger

  Required

  The offset of the items returned (as set in the query or by default)

  Example: 0
• previousstring

  Required

  Nullable

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

  Example: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
• totalinteger

  Required

  The total number of items available to return.

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

    • spotifystring

      The Spotify URL for the object.

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

    • urlstring

      Required

      The source URL of the image.

      Example: "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228"
    • heightinteger

      Required

      Nullable

      The image height in pixels.

      Example: 300
    • widthinteger

      Required

      Nullable

      The image width in pixels.

      Example: 300
  • namestring

    The name of the playlist.

  • The user who owns the playlist

    • Known public external URLs for this user.

      • spotifystring

        The Spotify URL for the object.

    • hrefstring

      A link to the Web API endpoint for this user.

    • idstring

      The Spotify user ID for this user.

    • typestring

      The object type.

      Allowed values: "user"
    • uristring

      The Spotify URI for this user.

    • display_namestring

      Nullable

      The name displayed on the user's profile. null if not available.

  • publicboolean

    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_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 items can be retrieved, along with the total number of items in the playlist. Note, a track object may be null. This can happen if a track is no longer available.

    • hrefstring

      A link to the Web API endpoint where full details of the playlist's tracks can be retrieved.

    • totalinteger

      Number of tracks in the playlist.

  • Deprecated

    Deprecated: Use items instead. 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.

    • hrefstring

      A link to the Web API endpoint where full details of the playlist's tracks can be retrieved.

    • totalinteger

      Number of tracks in the playlist.

  • typestring

    The object type: "playlist"

  • uristring

    The Spotify URI for the playlist.

Response sample