Skip to main content
GET
Get a track's royalty lifecycle since release
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

Get a track’s royalty lifecycle since release Charts royalty and count per month-since-release for one or more tracks, anchored at the track’s release date (or, if unavailable, its first observed sale — see anchorSource). Requires at least one of isrc or assetId. Unlike the other royalty endpoints, start/end do not scope this endpoint — it always returns full track history so the lifecycle curve isn’t clipped. Dimension filters such as country and dsp are still applied. Authorization:
  • Required role: user or higher

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Query Parameters

isrc
string

Comma-separated list of ISRCs to chart. At least one of isrc or assetId is required. Non-alphanumeric characters are stripped and the value upper-cased; de-duplicated and capped at 50 ISRCs total

assetId
string

Comma-separated list of asset IDs to chart. Resolved to ISRCs via a tenant-scoped catalog lookup. At least one of isrc or assetId is required

user
string<uuid>

Filters the data by user. Specifies a user ID. A single UUID switches the response into per-member (splits-attributed) mode

country
string

Filter the data by country. Comma-separated values

dsp
string

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

Response

Successfully retrieved the lifecycle series (or an empty results with reason set if nothing could be charted)

results
object[]
reason
enum<string> | null

Set when results is empty, explaining why. Null on a normal populated response

Available options:
no-isrc-input,
no-anchor-date,
no-sales-rows