Skip to main content
GET
/
royalty
/
aggregator
Get Royalties grouped by aggregator
curl --request GET \
  --url https://api.royalti.io/royalty/aggregator \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "Aggregator": "DistroKid",
      "Royalty": 3256.75,
      "Count": 325000,
      "RoyaltyPercentage": 15.8,
      "CountPercentage": 12.3,
      "RatePer1K": 10.02,
      "PreviousRoyalty": 2809.45,
      "PreviousCount": 289150
    },
    {
      "Aggregator": "TuneCore",
      "Royalty": 1856.5,
      "Count": 185000,
      "RoyaltyPercentage": 8.5,
      "CountPercentage": 6.2,
      "RatePer1K": 10.03,
      "PreviousRoyalty": 1710.2,
      "PreviousCount": 174050
    },
    {
      "Aggregator": "CD Baby",
      "Royalty": 1056.25,
      "Count": 105000,
      "RoyaltyPercentage": 3.2,
      "CountPercentage": 2.1,
      "RatePer1K": 10.06,
      "PreviousRoyalty": 1023.8,
      "PreviousCount": 102850
    }
  ]
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Description

Get Royalties grouped by aggregator This endpoint retrieves royalty data grouped by aggregator/distributor, showing revenue breakdown by distribution partner.

​
Code Examples

const response = await fetch('https://api.royalti.io/royalty/aggregator', {
  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

​
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
​
page
integer

Page number for pagination

Required range: x >= 1
​
size
integer

Number of items per page

Required range: 1 <= x <= 100

Response

Successfully retrieved royalty data by aggregator

​
results
object[]
​
totalItems
integer

Total number of items (when paginated)

​
totalPages
integer

Total number of pages (when paginated)

​
currentPage
integer

Current page number (when paginated)

​
filteredItems
integer

Number of items in current page (when paginated)