Skip to main content
The BeatPass API provides access to platform data for approved developer integrations and partnerships. All authenticated requests use authentication.
API access is invite-only. Developer tokens are granted on a case-by-case basis. To request access, contact contact@beatpass.ca. See Authentication for details.

Quickstart

Get up and running quickly

Authentication

Learn the auth flow

API Reference

Explore all endpoints

​
Integration Requests

If you’re interested in integrating with BeatPass (partnerships, data licensing, embedded players), contact support to discuss options.

Partnership Inquiries

Contact support for integration discussions.

​
Base URL

All API requests use the base URL: 
https://open.beatpass.ca/api/v1

​
API Surface

The BeatPass API provides comprehensive functionality across the platform:

Tracks

List, view, upload, update, delete tracks

Albums

Album management and metadata

Artists

Artist profiles, followers, tracks

Playlists

Create, manage, share playlists

Search

Full-text search across content types

Genres

Genre listing and filtering

Lyrics

Synced and plain lyrics management

Radio

Personalized music recommendations

​
Request Format

​
HTTP Methods

GET

Retrieve data

POST

Create resources

PUT

Update resources

DELETE

Remove resources

​
Required Headers

Accept: application/json
Content-Type: application/json
Authenticated requests must include a valid Bearer token. See the Authentication guide for details.

​
Response Format

​
Success Response

Responses vary by endpoint. Most return data directly: 
{
  "id": 1234,
  "name": "Track Name",
  "artist": {...}
}

​
Error Response

{
  "message": "Error description",
  "errors": {
    "field": ["Validation error"]
  }
}

​
Pagination

Paginated endpoints use standard : 
{
  "data": [...],
  "current_page": 1,
  "per_page": 15,
  "total": 150,
  "last_page": 10,
  "links": {...}
}

​
Authentication & Data Access

The BeatPass API uses a for external consumers:
TierAuthData
PublicNoneMinimal (id, name, model_type only)
TokenBearer {token}Rich (pricing, plays, BPM, licensing)
Unauthenticated requests return minimal data. You must have an approved Bearer token to access rich API responses. See Authentication for details.

​
Endpoint Categories

The API provides read access to public content (tracks, artists, albums, genres, search) and authenticated access to user-specific features (library, playlists, messaging, purchases, analytics). See the API Reference for the full endpoint listing.

​
Rate Limiting

The API enforces rate limits to ensure fair usage and platform stability. Exceeding limits returns a 429 Too Many Requests response.

Rate Limits Reference

View rate limiting documentation and best practices.

​
Terms of Use

API access is subject to the BeatPass Terms of Service. The following are strictly prohibited:
  • Scraping or crawling platform content
  • Bypassing rate limits or access controls
  • Accessing undocumented or internal endpoints
  • Redistributing API data without permission
  • Automated bulk collection of catalog data
Violations result in immediate token revocation and account termination.
Found a security issue? Report it responsibly to contact@beatpass.ca — we appreciate responsible disclosure.

​
Next Steps

Authentication

Learn how API authentication works.

API Reference

Complete endpoint reference.
Last modified on February 21, 2026