🎭 Artist Roles

Standardized roles that define how artists contribute to musical works

Resource Overview

Artist Roles define standardized roles that artists can have in musical works, such as "main artist", "featuring", "producer", etc. This is a read-only reference resource that provides consistent role definitions used throughout the platform.

Base Endpoint
/artist-roles
Resource Type
artist-roles
Access Mode
Read-only Reference

Schema

Attributes

Field Type Visibility Description
id integer Public Unique identifier for the artist role
key string Public Sortable Machine-readable identifier (e.g., "main_artist", "featuring")

Available Filters

By ID

filter[id]=1,2,3

Filter by specific role IDs

By Key

filter[key]=main_artist,featuring

Filter by role keys

Relationships

album-artists

Album artist relationships using this role

hasMany

track-artists

Track artist relationships using this role

hasMany

API Endpoints

List Artist Roles

GET
GET /artist-roles

Query Parameters

filter[id] - Filter by role IDs
filter[key] - Filter by role keys
sort - Sort by: key
page[number] - Page number (default: 1)
page[size] - Items per page (default: 20)

Example Request

GET /artist-roles?filter[key]=main_artist,featuring&sort=key

Example Response

{
  "data": [
    {
      "type": "artist-roles",
      "id": "1",
      "attributes": {
        "id": 1,
        "key": "main_artist"
      }
    },
    {
      "type": "artist-roles",
      "id": "2",
      "attributes": {
        "id": 2,
        "key": "featuring"
      }
    }
  ],
  "meta": {
    "page": {
      "currentPage": 1,
      "from": 1,
      "lastPage": 1,
      "perPage": 20,
      "to": 2,
      "total": 2
    }
  }
}

Get Artist Role

GET
GET /artist-roles/{id}

Path Parameters

id (required) - The ID of the artist role to retrieve

Example Request

GET /artist-roles/1

Example Response

{
  "data": {
    "type": "artist-roles",
    "id": "1",
    "attributes": {
      "id": 1,
      "key": "main_artist"
    }
  }
}

Common Artist Roles

The platform includes several standard artist roles. Here are some common examples:

main_artist

Primary artist of the release

featuring

Featured artist collaboration

producer

Producer of the track

composer

Composer of the music

lyricist

Writer of the lyrics

remixer

Remixer of the original track

Usage Examples

Get All Available Roles

GET /artist-roles?sort=key

Get Specific Roles

GET /artist-roles?filter[key]=main_artist,featuring

Using in Artist Relationships

Artist roles are typically used when creating album-artist or track-artist relationships:

Request Body Example

{
  "data": {
    "type": "track-artists",
    "attributes": {
      "order": 1
    },
    "relationships": {
      "track": {
        "data": { "type": "tracks", "id": "123" }
      },
      "artist": {
        "data": { "type": "artists", "id": "456" }
      },
      "artist-role": {
        "data": { "type": "artist-roles", "id": "1" }
      }
    }
  }
}
Track Artists

Reference Resources

Labels