BeatPass Documentation - Help Center & Developer Docs

Get list of albums

curl --request GET \
  --url https://open.beatpass.ca/api/v1/albums \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://open.beatpass.ca/api/v1/albums', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://open.beatpass.ca/api/v1/albums",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://open.beatpass.ca/api/v1/albums"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://open.beatpass.ca/api/v1/albums")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "albums": {
    "current_page": 1,
    "from": 1,
    "to": 100,
    "per_page": 25,
    "last_page": 156,
    "total": 264,
    "data": [
      {
        "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
          }
        ]
      }
    ]
  }
}

GET

albums

Get list of albums

curl --request GET \
  --url https://open.beatpass.ca/api/v1/albums \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://open.beatpass.ca/api/v1/albums', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://open.beatpass.ca/api/v1/albums",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://open.beatpass.ca/api/v1/albums"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://open.beatpass.ca/api/v1/albums")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "albums": {
    "current_page": 1,
    "from": 1,
    "to": 100,
    "per_page": 25,
    "last_page": 156,
    "total": 264,
    "data": [
      {
        "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
          }
        ]
      }
    ]
  }
}

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.

Query Parameters

page

integer

Page number

Example:

1

per_page

integer

Items per page

Example:

25

Response

List of albums

status

string

Example:

"success"

albums

object

Show child attributes

Last modified on July 31, 2026

Get an Album Create a new album

Introduction

Core Concepts

API Reference

Search

Playlists

Artists

Albums

Tracks

Tags

Genres

Users

Auth

License Certificates

Audio Fingerprinting

Playlist Collaboration

Reposts

Track Plays

Radio

Cover Art

Track Purchases

Beat Requests

Producer Intelligence

User Library

Leaderboards

Messaging

Collections

Stripe Connect

Exclusive Licenses

Coupons

Notifications

Get list of albums

Authorizations

Query Parameters

Response