Skip to content
Web API •References / Shows / Get User's Saved Shows

Get User's Saved 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.

Authorization scopes

Request

  • 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 item to return. Default: 0 (the first item). Use with limit to get the next set of items.

    Example value: 5Default value: 0

Response

Pages of shows

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

    • Information about the show.