Skip to main content
GET
/
artist
/
{id}
/
assets
Get Artist Assets
curl --request GET \
  --url https://api.royalti.io/artist/{id}/assets \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "123",
    "title": "Song Title",
    "isrc": "USABC1234567",
    "status": "published",
    "splitCount": 3,
    "count": 15000,
    "royalty": 2500.75,
    "Products": [
      {
        "id": "prod-456",
        "upc": "123456789012",
        "title": "Album Title",
        "isDraft": false
      }
    ],
    "Artists": [
      {
        "id": "456",
        "artistName": "Main Artist",
        "type": "primary"
      }
    ]
  }
]
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Description

artist//assets Description:
The /artist/{id}/assets endpoint retrieves all assets associated with a specific artist, including related products and statistics. Method:
GET Path Parameter:
ParameterTypeDescription
id (required)stringThe unique identifier of the artist.
page (optional)integerPage number for pagination (default: 1)
size (optional)integerNumber of assets per page (default: 10)
type (optional)stringFilter by asset type (default: all)
Response Includes:
  • Basic asset information
  • Related products (id, upc, title, isDraft)
  • Split count (number of splits associated with the asset)
  • Total play/stream count (sum of AssetStats and ProductStats)
  • Total royalties (sum of royalties from AssetStats and ProductStats)
  • Artist information including the type of association | type (Optional) | string | Filter by asset type. |

​
Code Examples

const response = await fetch('https://api.royalti.io/artist/example-id/assets', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`,
  },
});

const data = await response.json();
console.log(data);

Authorizations

​
Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

​
id
string
required

Artist ID

Query Parameters

​
page
integer
default:1

Page number for pagination

​
size
integer
default:10

Number of assets per page

​
type
string

Filter by asset type

Response

Success

​
id
string

Unique identifier of the asset

​
title
string

Title of the asset

​
isrc
string

ISRC code of the asset

​
status
enum<string>

Current status of the asset

Available options:
draft,
published,
archived
​
splitCount
integer

Number of splits associated with this asset

​
count
number

Total play/stream count across all platforms

​
royalty
number

Total royalties generated by this asset

​
Products
object[]
​
Artists
object[]