---
title: "Get User's Saved Shows"
method: GET
path: "/me/shows"
tags: ["Shows", "Library"]
---

# Get User's Saved Shows

`GET /me/shows`

Get a list of shows saved in the current Spotify user's library. Optional parameters can be used to limit the number of shows returned.

## Query parameters

- `limit` integer — The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
- `offset` integer — The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.

## Response `200`

Pages of shows

- PagingSavedShowObject
  - `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` SavedShowObject[], required
    - `added_at` string, date-time — The date and time the show was saved. Timestamps are returned in ISO 8601 format as Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ. If the time is imprecise (for example, the date/time of an album release), an additional field indicates the precision; see for example, release_date in an album object.
    - `show` SimplifiedShowObject
      - `available_markets` string[], required — A list of the countries in which the show can be played, identified by their [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code.
      - `copyrights` CopyrightObject[], required — The copyright statements of the show.
        - `text` string — The copyright text for this content.
        - `type` string — The type of copyright: `C` = the copyright, `P` = the sound recording (performance) copyright.
      - `description` string, required — A description of the show. HTML tags are stripped away from this field, use `html_description` field in case HTML tags are needed.
      - `html_description` string, required — A description of the show. This field may contain HTML tags.
      - `explicit` boolean, required — Whether or not the show has explicit content (true = yes it does; false = no it does not OR unknown).
      - `external_urls` ExternalUrlObject, required
        - `spotify` string — The [Spotify URL](/documentation/web-api/concepts/spotify-uris-ids) for the object.
      - `href` string, required — A link to the Web API endpoint providing full details of the show.
      - `id` string, required — The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the show.
      - `images` ImageObject[], required — The cover art for the show in various sizes, widest first.
        - `url` string, required — The source URL of the image.
        - `height` integer, nullable, required — The image height in pixels.
        - `width` integer, nullable, required — The image width in pixels.
      - `is_externally_hosted` boolean, required — True if all of the shows episodes are hosted outside of Spotify's CDN. This field might be `null` in some cases.
      - `languages` string[], required — A list of the languages used in the show, identified by their [ISO 639](https://en.wikipedia.org/wiki/ISO_639) code.
      - `media_type` string, required — The media type of the show.
      - `name` string, required — The name of the episode.
      - `publisher` string, required — The publisher of the show.
      - `type` 'show', required — The object type.
      - `uri` string, required — The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the show.
      - `total_episodes` integer, required — The total number of episodes in the show.

## 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.dev/spotify/apis/spotify-web-api.md) · [All operations](https://skmtc.dev/spotify/apis/spotify-web-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spotify/spotify-web-api/revisions/2d888d731358/schema)