---
title: "Get User's Playlists"
method: GET
path: "/users/{user_id}/playlists"
tags: ["Playlists", "Users"]
---

# Get User's Playlists

`GET /users/{user_id}/playlists`

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

## Path parameters

- `user_id` string, required — The user's [Spotify user ID](/documentation/web-api/#spotify-uris-and-ids).

## Query parameters

- `limit` integer — The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 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.

## Response `200`

A paged set of playlists

- PagingPlaylistObject
  - `href` string, required — A link to the Web API endpoint returning the full result of the request
  - `limit` integer, required — The maximum number of items in the response (as set in the query or by default).
  - `next` string, nullable, required — URL to the next page of items. ( `null` if none)
  - `offset` integer, required — The offset of the items returned (as set in the query or by default)
  - `previous` string, nullable, required — URL to the previous page of items. ( `null` if none)
  - `total` integer, required — The total number of items available to return.
  - `items` SimplifiedPlaylistObject[], 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`.
    - `external_urls` ExternalUrlObject
      - `spotify` string — The [Spotify URL](/documentation/web-api/#spotify-uris-and-ids) for the object.
    - `href` string — A link to the Web API endpoint providing full details of the playlist.
    - `id` string — The [Spotify ID](/documentation/web-api/#spotify-uris-and-ids) for the playlist.
    - `images` ImageObject[] — 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](/documentation/general/guides/working-with-playlists/). _**Note**: If returned, the source URL for the image (`url`) is temporary and will expire in less than a day._
      - `height` integer, nullable, required — The image height in pixels.
      - `url` string, required — The source URL of the image.
      - `width` integer, nullable, required — The image width in pixels.
    - `name` string — The name of the playlist.
    - `owner` PlaylistOwnerObject
      - `external_urls` ExternalUrlObject
        - `spotify` string — The [Spotify URL](/documentation/web-api/#spotify-uris-and-ids) for the object.
      - `followers` FollowersObject
        - `href` string, nullable — This will always be set to null, as the Web API does not support it at the moment.
        - `total` integer — The total number of followers.
      - `href` string — A link to the Web API endpoint for this user.
      - `id` string — The [Spotify user ID](/documentation/web-api/#spotify-uris-and-ids) for this user.
      - `type` 'user' — The object type.
      - `uri` string — The [Spotify URI](/documentation/web-api/#spotify-uris-and-ids) 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: `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](/documentation/general/guides/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
    - `tracks` PlaylistTracksRefObject
      - `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](/documentation/web-api/#spotify-uris-and-ids) for the playlist.

## Other responses

- `401` — Bad or expired token. This can happen if the user revoked a token or the access token has expired. You should re-authenticate the user.
- `403` — Bad OAuth request (wrong consumer key, bad nonce, expired timestamp...). Unfortunately, re-authenticating the user won't help here.
- `429` — The app has exceeded its rate limits.

---

[API](https://skmtc.net/spotify/apis/sonallux.md) · [All operations](https://skmtc.net/spotify/apis/sonallux/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spotify/sonallux/versions/1459b27f2e48/schema)