Skip to main content
GET
/
royalty
/
asset
Get Royalties grouped by asset
curl --request GET \
  --url https://server26-dot-royalti-project.uc.r.appspot.com/royalty/asset \
  --header 'Authorization: Bearer <token>'
[
  {
    "assetId": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
    "assetTitle": "Hit Single",
    "isrc": "USABC1234567",
    "totalRoyalty": 1856.25,
    "totalCount": 185000,
    "percentage": "30.1%"
  },
  {
    "assetId": "b2c3d4e5-f6a7-8901-2345-67890abcdef1",
    "assetTitle": "Popular Track",
    "isrc": "USABC1234568",
    "totalRoyalty": 1256.75,
    "totalCount": 125000,
    "percentage": "20.4%"
  }
]
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Code Examples

const response = await fetch('https://server26-dot-royalti-project.uc.r.appspot.com/royalty/asset', {
  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}"

Query Parameters

​
artists
string

Filters the data by artist. Comma-separated list of artist IDs

​
user
string<uuid>

Filters the data by user. Specifies a user ID

​
country
string

Filter the data by country. Comma-separated values

​
dsp
string

Filters by DSP (Digital Service Provider). Comma-separated values

​
start
string<date>

Start date of the period (YYYY-MM-DD format)

​
end
string<date>

End date of the period (YYYY-MM-DD format)

​
type
string

Filters by sale type. Comma-separated values

​
aggregator
string

Filters by aggregator. Comma-separated values

​
table_name
string

Filters by data source table name. Comma-separated values for multiple tables

​
upc
string

Filters by UPC (Universal Product Code). Comma-separated values

​
isrc
string

Filters by ISRC (International Standard Recording Code). Comma-separated values

​
periodFilterType
enum<string>

Filters by either 'accounting' or 'sale' period

Available options:
accounting,
sale

Response

Successfully retrieved royalty data by asset

​
assetId
string<uuid>

Asset unique identifier

​
assetTitle
string

Asset title

​
isrc
string

International Standard Recording Code

​
totalRoyalty
number

Total royalty for this asset

​
totalCount
integer

Total plays/sales for this asset

​
percentage
string

Percentage of total royalties