> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.royalti.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Artist Assets
> **artist/{id}/assets**
This endpoint requires authentication. Include your Bearer token in the Authorization header.
## Description
**artist/{id}/assets**
**Description:**
The `/artist/{id}/assets` endpoint retrieves all assets associated with a specific artist, including related products and statistics.
**Method:**
`GET`
**Path Parameter:**
| Parameter | Type | Description |
| ----------------- | ------- | --------------------------------------- |
| id *(required)* | string | The unique identifier of the artist. |
| page *(optional)* | integer | Page number for pagination (default: 1) |
| size *(optional)* | integer | Number of assets per page (default: 10) |
| type *(optional)* | string | Filter by asset type (default: all) |
**Response Includes:**
* Basic asset information
* Related products (id, upc, title)
* 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
```javascript Node.js theme={null}
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);
```
```python Python theme={null}
import requests
response = requests.get(
'https://api.royalti.io/artist/example-id/assets',
headers={
'Authorization': f'Bearer {token}'
},
)
data = response.json()
print(data)
```
```bash cURL theme={null}
curl -X GET https://api.royalti.io/artist/example-id/assets \
-H "Authorization: Bearer YOUR_TOKEN" \
```
## OpenAPI
````yaml get /artist/{id}/assets
openapi: 3.0.0
info:
title: Royalti.io API
description: "# Royalti API\r\n\r\nThis is the Royalti music royalty management platform API server.\r\n\r\n## Overview\r\n\r\nThe Royalti API provides comprehensive music royalty management services including:\r\n- Music publishing and writer management\r\n- Royalty processing and analytics\r\n- DDEX integration for music industry standards\r\n- File processing and pattern recognition\r\n- Payment processing and distribution\r\n\r\n## Authentication\r\n\r\nThe API uses JWT-based authentication with multiple protection levels:\r\n- Public endpoints for basic operations\r\n- Protected endpoints requiring valid JWT tokens\r\n- Admin endpoints for administrative functions\r\n\r\n## Features\r\n\r\n- Multi-dimensional royalty analytics\r\n- CWR (Collective Works Registration) support\r\n- DDEX integration for music metadata\r\n- Advanced file processing with pattern recognition\r\n- Real-time data processing with queue system"
version: 2.6.0
contact:
name: Royalti.io Support
email: support@royalti.io
url: https://royalti.io
license:
name: Proprietary
url: https://royalti.io/terms
servers:
- url: https://api.royalti.io
description: Production server
- url: https://api-dev.royalti.io
description: Development server
- url: http://localhost:8084
description: Local development
security:
- bearerAuth: []
tags:
- name: Accounting
description: Accounting and financial transaction operations
- name: DDEX
description: DDEX operations (ERN/MEAD, messages, delivery, providers)
- name: Label
description: Label management operations
- name: Internal Webhooks
description: Internal system webhooks for royalty processing and downloads
- name: Payment Webhooks
description: Payment processor webhook endpoints
- name: Billing Webhooks
description: Stripe billing and subscription webhooks
- name: Infrastructure Webhooks
description: Cloudflare domain and SSL webhooks
- name: Distribution Webhooks
description: Digital distribution platform webhooks (FUGA)
paths:
/artist/{id}/assets:
get:
tags:
- Artist
summary: Get Artist Assets
description: >-
**artist/{id}/assets**
**Description:**
The `/artist/{id}/assets` endpoint retrieves all assets associated with
a specific artist, including related products and statistics.
**Method:**
`GET`
**Path Parameter:**
| Parameter | Type | Description |
| --- | --- | --- |
| id *(required)* | string | The unique identifier of the artist. |
| page *(optional)* | integer | Page number for pagination (default: 1)
|
| size *(optional)* | integer | Number of assets per page (default: 10)
|
| type *(optional)* | string | Filter by asset type (default: all) |
**Response Includes:**
- Basic asset information
- Related products (id, upc, title)
- 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. |
parameters:
- name: id
in: path
required: true
description: Artist ID
schema:
type: string
- name: page
in: query
required: false
description: Page number for pagination
schema:
type: integer
default: 1
- name: size
in: query
required: false
description: Number of assets per page
schema:
type: integer
default: 10
- name: type
in: query
required: false
description: Filter by asset type
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: object
properties:
id:
type: string
description: Unique identifier of the asset
title:
type: string
description: Title of the asset
isrc:
type: string
description: ISRC code of the asset
status:
type: string
enum:
- draft
- published
- archived
description: Current status of the asset
splitCount:
type: integer
description: Number of splits associated with this asset
count:
type: number
description: Total play/stream count across all platforms
royalty:
type: number
description: Total royalties generated by this asset
Products:
type: array
items:
type: object
properties:
id:
type: string
description: Unique identifier of the product
upc:
type: string
description: UPC code of the product
title:
type: string
description: Title of the product
Artists:
type: array
items:
type: object
properties:
id:
type: string
description: Unique identifier of the artist
artistName:
type: string
description: Name of the artist
type:
type: string
enum:
- primary
- featuring
description: Type of artist contribution to the asset
example:
- 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
Artists:
- id: '456'
artistName: Main Artist
type: primary
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
security:
- bearerAuth: []
components:
schemas:
Error:
type: object
properties:
success:
type: boolean
example: false
error:
type: object
properties:
code:
type: string
message:
type: string
details:
type: array
items:
type: string
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: >-
JWT Authorization header using the Bearer scheme. Format: "Bearer
{token}"
````