💿 Album Formats

Three essential format classifications: Single, Ep, and Album

Resource Overview

Album Formats provide three essential classifications for music releases: Single (individual tracks), Ep (extended play collections), and Album (full-length releases). This read-only reference resource ensures consistent format categorization across the platform and aligns with industry standards for music distribution and metadata.

Base Endpoint
/album-formats
Resource Type
album-formats
Access Mode
Read-only Reference

Schema

Attributes

Field Type Visibility Description
id integer Public Unique identifier for the album format
name string Public Sortable Human-readable name of the format (e.g., "LP", "EP", "Single")

Available Filters

By ID

filter[id]=1,2,3

Filter by specific format IDs

By Name

filter[name]=LP,EP

Filter by format names

Relationships

albums

Albums that use this format classification

hasMany

API Endpoints

List Album Formats

GET
GET /album-formats

Query Parameters

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

Example Request

GET /album-formats?sort=name

Example Response

{
  "data": [
    {
      "type": "album-formats",
      "id": "3",
      "attributes": {
        "id": 3,
        "name": "Album"
      }
    },
    {
      "type": "album-formats",
      "id": "2",
      "attributes": {
        "id": 2,
        "name": "Ep"
      }
    },
    {
      "type": "album-formats",
      "id": "1",
      "attributes": {
        "id": 1,
        "name": "Single"
      }
    }
  ],
  "meta": {
    "page": {
      "currentPage": 1,
      "from": 1,
      "lastPage": 1,
      "perPage": 20,
      "to": 3,
      "total": 3
    }
  }
}

Get Album Format

GET
GET /album-formats/{id}

Path Parameters

id (required) - The ID of the album format to retrieve

Example Request

GET /album-formats/2

Example Response

{
  "data": {
    "type": "album-formats",
    "id": "2",
    "attributes": {
      "id": 2,
      "name": "Ep"
    }
  }
}

Available Album Formats

The platform includes three standard album format classifications:

Single

Individual track release, typically 1-2 songs for promotion

ID: 1

Ep

Extended Play, typically 3-6 tracks, 15-30 minutes duration

ID: 2

Album

Full-length album, typically 7+ tracks, 30+ minutes duration

ID: 3

Usage Examples

Get All Available Formats

GET /album-formats?sort=name

Get Specific Format Types

GET /album-formats?filter[name]=Album,Ep,Single

Using Format in Album Creation

Album formats are used when creating or updating albums to specify their format classification:

Album Creation Example

{
  "data": {
    "type": "albums",
    "attributes": {
      "title": "Night Sessions",
      "release_date": "2024-03-15"
    },
    "relationships": {
      "format": {
        "data": { "type": "album-formats", "id": "2" }
      },
      "label": {
        "data": { "type": "labels", "id": "123" }
      }
    }
  }
}

Business Context

Format Classification Importance

• Distribution Strategy: Different formats have different distribution requirements and strategies

• Platform Rules: Streaming platforms have specific rules and metadata requirements based on format

• Revenue Models: Singles vs albums have different monetization and promotion strategies

• Industry Standards: Format classification aligns with music industry standards and chart categorization

• User Experience: Helps users understand the type and scope of the musical content

Artist Roles

Supporting Data

Labels