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>"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.beatpass.ca/llms.txt

Use this file to discover all available pages before exploring further.

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 April 21, 2026