Skip to content
DocumentationAPI Reference

Check User's Saved Albums

client.me.albums.check(AlbumCheckParams { ids } query, RequestOptionsoptions?): 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
query: AlbumCheckParams { ids }
ids: string

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

ReturnsExpand Collapse
AlbumCheckResponse = Array<boolean>

Check User's Saved Albums

import Spotted from 'spotted-ts';

const client = new Spotted({
  accessToken: process.env['SPOTIFY_ACCESS_TOKEN'], // This is the default and can be omitted
});

const response = await client.me.albums.check({
  ids: '382ObEPsp2rxGrnsizN5TX,1A2GTWGtFfWp7KSQTwWOyo,2noRn2Aes5aoNVsU6iWThc',
});

console.log(response);
[
  false,
  true
]
Returns Examples
[
  false,
  true
]