Get the unified master + publishing + neighbouring-rights view
Get the unified master + publishing + neighbouring-rights view
Description
Get the unified master + publishing + neighbouring-rights view Shipped June 2026 (WP-08). Merges, per ISRC, master royalties (BigQueryv_sales_data), neighbouring-rights royalties (per-tenant
f_neighbouring_rights fact table, split into rightsholder vs. performer
payout), and publishing royalties (Postgres PublisherStatementLine,
matched by ISWC and crosswalked to ISRC via the catalog). Publishing income
that cannot be crosswalked to an ISRC is returned separately in unlinked
rather than dropped.
Only start, end, and user are honored by this endpoint — the other
royalty-filter query params accepted by sibling endpoints (country, dsp,
table_name, etc.) are not applied here.
Authorization:
- Required role:
useror higher
Code Examples
Authorizations
JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"
Query Parameters
Start date of the period (YYYY-MM-DD format)
End date of the period (YYYY-MM-DD format)
Filters the data by user. Specifies a user ID. A single UUID switches the response into per-member (splits-attributed, catalogue-scoped) mode
Response
Successfully retrieved the consolidated royalty view
Unified master + publishing + neighbouring-rights view per ISRC (shipped
June 2026). Non-admin/member requests (single-UUID ?user=) are
automatically scoped to that member's owned catalogue via splits, and fail
closed (empty result) rather than falling back to tenant-wide data on any
ownership-resolution error.