🔄 Versions

Version control and release management classifications

Resource Overview

Versions provide standardized version classifications for tracks and albums, enabling proper version control and release management. This read-only reference resource supports different version types such as remix, remaster, instrumental, and other variants essential for music catalog organization.

Base Endpoint
/versions
Resource Type
versions
Access Mode
Read-only Reference

Schema

Attributes

Field Type Visibility Description
id integer Public Unique identifier for the version
name string Public Read-only Human-readable name of the version type (e.g., "Original", "Remix", "Remaster")

Available Filters

By ID

filter[id]=1,2,3

Filter by specific version IDs

By Name

filter[name]=Original,Remix

Filter by version names

API Endpoints

List Versions

GET
GET /versions

Query Parameters

filter[id] - Filter by version IDs
filter[name] - Filter by version names
page[number] - Page number (default: 1)
page[size] - Items per page (default: 20)

Example Request

GET /versions

Example Response

{
  "data": [
    {
      "type": "versions",
      "id": "1",
      "attributes": {
        "id": 1,
        "name": "Original"
      }
    },
    {
      "type": "versions",
      "id": "2",
      "attributes": {
        "id": 2,
        "name": "Remix"
      }
    },
    {
      "type": "versions",
      "id": "3",
      "attributes": {
        "id": 3,
        "name": "Remaster"
      }
    }
  ],
  "meta": {
    "page": {
      "currentPage": 1,
      "from": 1,
      "lastPage": 1,
      "perPage": 20,
      "to": 3,
      "total": 3
    }
  }
}

Get Version

GET
GET /versions/{id}

Path Parameters

id (required) - The ID of the version to retrieve

Example Request

GET /versions/1

Example Response

{
  "data": {
    "type": "versions",
    "id": "1",
    "attributes": {
      "id": 1,
      "name": "Original"
    }
  }
}

Common Version Types

The platform includes several standard version classifications for proper catalog organization:

Original

The original recording/release version

Remix

Altered version with different arrangement or mix

Remaster

Enhanced version with improved audio quality

Instrumental

Version without vocals, only instrumental

Acoustic

Stripped-down version with acoustic instruments

Live

Recorded during live performance

Usage Examples

Get All Available Versions

GET /versions

Get Specific Version Types

GET /versions?filter[name]=Original,Remix,Remaster

Using Version in Track Creation

Versions are used when creating or updating tracks to specify their version classification:

Track Creation Example

{
  "data": {
    "type": "tracks",
    "attributes": {
      "title": "Electric Dreams",
      "length": "00:04:32",
      "isrc": "USRC17607839"
    },
    "relationships": {
      "version": {
        "data": { "type": "versions", "id": "2" }
      },
      "album": {
        "data": { "type": "albums", "id": "123" }
      }
    }
  }
}

Business Context

Version Management Importance

• Catalog Organization: Proper versioning helps organize complex music catalogs with multiple variations

• Rights Management: Different versions may have different rights, royalties, and licensing terms

• Distribution Strategy: Versions enable strategic release planning (original first, then remixes, etc.)

• Metadata Standards: Aligns with industry standards for music metadata and digital distribution

• User Experience: Helps users understand the nature and context of different track variations

• Analytics Tracking: Enables separate performance tracking for different versions of the same content

Album Formats

Supporting Data

Labels