Skip to the content
Get an API key
  1. API reference
  2. Read and write a user's library

Get album

GET/api/{integrationUserUUID}/albums/{albumId}
CoreAuthBasicDevTokenDocsSessionToken

This endpoint fetches specified album and returns information about it.

Path parameters

integrationUserUUID
uuidrequired

The connected user: the integrationUserUUID from the sign-in callback.

albumId
stringrequired

ID of the album

Response

200application/json · Albumok
id
string
required
name
string
required
totalItems
number | null
required
imageUrl
string | null
required
artists
ArtistSimplified[] | null
required
artists.id
string | null
required
artists.entryId
string | null
requiredIdentifier associated with an artist within a user's library. Artist entry id can be obtained during fetching artists from user's library.
artists.name
string
required
artists.imageUrl
string | null
required
artists.followers
number | null
required
Example answer
{
  "id": "4Gfnly5CzMJQqkUFfoHaP3",
  "name": "Meteora",
  "totalItems": 13,
  "imageUrl": "https://www.example-image.com/978263478234",
  "artists": [
    {
      "id": "53XhwfbYqKCa1cC15pYq2q",
      "entryId": "53XhwfbYqKCa1cC15pYq2q",
      "name": "Imagine Dragons",
      "imageUrl": "https://i.scdn.co/image/ab6761610000e5ebab47d8dae2b24f5afe7f9d38",
      "followers": 53107521
    }
  ]
}

Errors

404

Your account has no connected user with this uuid, or the item does not exist.

412

The user must sign in again (IntegrationUserNotAuthenticated).

429

Too many requests. Wait for the seconds in Retry-After.