Skip to main content
GET
/
artist
/
{id}
/
assets
Get Artist Assets
curl --request GET \
  --url https://server26-dot-royalti-project.uc.r.appspot.com/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"
      }
    ]
  }
]
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
idstringThe unique identifier of the artist.
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. |

Authentication

This endpoint requires authentication. Include your bearer token in the Authorization header.

Path Parameters

ParameterTypeInRequiredDescription
idstringpathāœ…Artist ID

Query Parameters

ParameterTypeInRequiredDescription
pageintegerqueryāŒPage number for pagination
sizeintegerqueryāŒNumber of assets per page
typestringqueryāŒFilter by asset type

Responses

āœ… 200 - Success

āš ļø 401 - Unauthorized

āš ļø 404 - Not Found

āŒ 500 - Internal Server Error

Tags

Artist

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[]
⌘I