Skip to main content
GET
/
albums
/
{id}
Get an Album
curl --request GET \
  --url https://open.beatpass.ca/api/v1/albums/{id} \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "album": {
    "id": 123,
    "name": "Coda",
    "image": "https://example.com/image1.jpg",
    "release_date": "1982-11-19",
    "description": "<string>",
    "tracks": [
      {
        "id": 123,
        "name": "Hey Hey What Can I Do",
        "release_date": "1982-11-19",
        "image": "https://example.com/image1.jpg",
        "duration": 5645848548,
        "description": "<string>",
        "artists": [
          {
            "id": 123,
            "name": "Led Zeppelin",
            "image_small": "https://example.com/image1.jpg",
            "verified": true
          }
        ]
      }
    ],
    "artists": [
      {
        "id": 123,
        "name": "Led Zeppelin",
        "image_small": "https://example.com/image1.jpg",
        "verified": true
      }
    ],
    "genres": [
      {
        "id": 1,
        "name": "rock"
      }
    ],
    "tags": [
      {
        "id": 123,
        "name": "<string>"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
integer
required

ID of the album

Query Parameters

with
string

Comma separated list of additional data to fetch for this album. Supported values: tags, genres, artists, tracks.

Example:

"artists,genres,tags"

Response

Response body contains an album object in JSON format.

status
string
Example:

"success"

album
object
Last modified on November 29, 2025