Skip to main content
GET
/
royalty
/
product
Get Royalties grouped by product
curl --request GET \
  --url https://server26-dot-royalti-project.uc.r.appspot.com/royalty/product \
  --header 'Authorization: Bearer <token>'
[
  {
    "productId": "p1b2c3d4-e5f6-7890-1234-567890abcdef",
    "productTitle": "Greatest Hits Album",
    "upc": "123456789012",
    "totalRoyalty": 3256.75,
    "totalCount": 325000,
    "percentage": "52.8%"
  },
  {
    "productId": "p9e8d7c6-b5a4-3210-9876-543210fedcba",
    "productTitle": "Latest Single",
    "upc": "987654321098",
    "totalRoyalty": 1756.5,
    "totalCount": 175000,
    "percentage": "28.5%"
  }
]
Get Royalties grouped by product This endpoint retrieves royalty data grouped by product (albums, singles, etc.), showing revenue breakdown per product.

​
Authentication

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

​
Query Parameters

ParameterTypeInRequiredDescription
artistsstringquery❌Filters the data by artist. Comma-separated list of artist IDs
userstringquery❌Filters the data by user. Specifies a user ID
countrystringquery❌Filter the data by country. Comma-separated values
dspstringquery❌Filters by DSP (Digital Service Provider). Comma-separated values
startstringquery❌Start date of the period (YYYY-MM-DD format)
endstringquery❌End date of the period (YYYY-MM-DD format)
typestringquery❌Filters by sale type. Comma-separated values
aggregatorstringquery❌Filters by aggregator. Comma-separated values
isrcstringquery❌Filters by ISRC (International Standard Recording Code). Comma-separated values
periodFilterTypestringquery❌Filters by either ‘accounting’ or ‘sale’ period

​
Responses

​
✅ 200 - Successfully retrieved royalty data by product

​
⚠️ 401 - Unauthorized

​
❌ 500 - Internal Server Error

​
Tags

Royalties

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

​
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 product

​
productId
string<uuid>

Product unique identifier

​
productTitle
string

Product title

​
upc
string

Universal Product Code

​
totalRoyalty
number

Total royalty for this product

​
totalCount
integer

Total plays/sales for this product

​
percentage
string

Percentage of total royalties

⌘I