Get a track's royalty lifecycle since release
Get a track’s royalty lifecycle since release
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 — seeanchorSource). 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:
useror higher
Code Examples
Authorizations
JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"
Query Parameters
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
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
Filters the data by user. Specifies a user ID. A single UUID switches the response into per-member (splits-attributed) mode
Filter the data by country. Comma-separated values
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)