Skip to content
DocumentationAPI Reference

Check User's Saved Albums

me.albums.check(AlbumCheckParams**kwargs) -> AlbumCheckResponse
GET/me/albums/contains

Check if one or more albums is already saved in the current Spotify user's 'Your Music' library.

ParametersExpand Collapse
ids: str

A comma-separated list of the Spotify IDs for the albums. Maximum: 20 IDs.

ReturnsExpand Collapse
List[bool]

Check User's Saved Albums

import os
from spotted import Spotted

client = Spotted(
    access_token=os.environ.get("SPOTIFY_ACCESS_TOKEN"),  # This is the default and can be omitted
)
response = client.me.albums.check(
    ids="382ObEPsp2rxGrnsizN5TX,1A2GTWGtFfWp7KSQTwWOyo,2noRn2Aes5aoNVsU6iWThc",
)
print(response)
[
  false,
  true
]
Returns Examples
[
  false,
  true
]