GET
/
royalty
/
aggregator
Get Royalties grouped by aggregator
curl --request GET \
  --url https://server26-dot-royalti-project.uc.r.appspot.com/royalty/aggregator \
  --header 'Authorization: Bearer <token>'
[
  {
    "aggregator": "DistroKid",
    "totalRoyalty": 3256.75,
    "totalCount": 325000,
    "percentage": "52.8%"
  },
  {
    "aggregator": "TuneCore",
    "totalRoyalty": 1856.5,
    "totalCount": 185000,
    "percentage": "30.1%"
  },
  {
    "aggregator": "CD Baby",
    "totalRoyalty": 1056.25,
    "totalCount": 105000,
    "percentage": "17.1%"
  }
]

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

ā€‹
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

200
application/json

Successfully retrieved royalty data by aggregator

The response is of type object[].