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

API access is invite-only. Contact contact@beatpass.ca to request access. Once approved, generate tokens from Account Settings → Developers. Include as: Authorization: Bearer {token}. Tokens expire after 90 days.

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 March 20, 2026