Coming soon: The Luminate Musical Rights API

Coming soon: The Luminate Musical Rights API

Starting in 2025, we’re introducing a new system for faster, simpler and more responsive claims submission. The enhanced claims process, supported by a purpose-built Musical Rights API, will go live later this year. Until then, here's what to expect and how to prepare.


 

Simplified claims submission

The legacy system did not offer a consistent way to submit claims and onboard new claim providers. The new system is streamlined and easy to implement; we’ll also offer templates, forms and step-by-step instructions for using the API. 


One system for all rights holders 

The new claims process gives all rights holders—new and existing—access to the Musical Rights API. Even if you’ve never sent us claims data before, you’ll be able to submit via API as soon as it’s available. 


Support for multiple claim types

Luminate historically tracked distribution rights only, with limited visibility into ownership. The new system supports ownership and distribution claims for recordings and products in the U.S. and Canada. We’ll also be able to add more claim types in the future.


Market share visibility 

Musical rights claimed via API will automatically be incorporated into Luminate’s market share calculations. The CONNECT platform will show ownership and distribution splits for musical assets and offer more overall visibility into market share. 


On-demand, anytime claims

Modern music distribution isn’t bound to rigid release days or predictable schedules. The new normal is off-schedule, “anytime” releases—sometimes on short notice. Our enhanced process permits rights holders to send claims on demand, in any order, anytime throughout the day for nightly processing and next-day rights assignment. 


Custom effective dates 

Claims submitted using the new process can specify applicable date ranges that start in the past or on a future date. CONNECT will automatically update claims to reflect new, updated or expired effective dates. 


Instant error detection 

Finding and correcting errors in manual submissions is time-consuming, costly and not guaranteed. But the new API and updated Market Share reporting process will detect errors, discrepancies and missing data automatically. If your submission is unsuccessful, the system will flag issues and alert you right away. 




Back to Musical Rights

Back to Registration and Reporting


What you’ll need 

Prepare to submit your claims to CONNECT by gathering or verifying the below. 


Registered musical assets 

We can only accept claims on musical assets in our database. Recordings and products must be registered with a valid ISRC or ICPN; only then can we 1) display them in CONNECT and 2) assign claims information. 

To prevent backlogs, submit new rights claims immediately after you register recordings and products with us. Check submission status by performing an ID Search with the ISRC or ICPN.



API access

If you’ve submitted claims in the past or requested to become a new claims provider, we’ll let you know when the Musical Rights API is available. If you choose to start using the API, we’ll supply an API key and instructions as part of the onboarding process.



Data and metadata 

For each asset you claim, you’ll need to submit key data and metadata in a standard format. 


Asset identifiers 

Each claim must include at least one standard ID code. For Products, we accept ICPN, GRiD, UPC and EAN codes. For Recordings, we only accept ISRCs.


Claims information
  • Rights Type: Distribution or Ownership

  • Catalog Code: User-specified string identifying the rights holder within your organization (label, sublabel, imprint, etc.) or the catalog it belongs to. 

  • Channel (Distribution): List of claimed distribution channels (Physical, Digital) for Distribution claims

  • Territories: List of the claimed countries (2 character ISO country codes)*

  • Share (Ownership): Percent of ownership claimed 

  • Effective Date: Earliest date on which the musical rights claim becomes valid

*Currently accepting U.S. and Canada only 


Metadata 

We require some metadata fields to validate claims and assign them to the correct entities in CONNECT.

  • Display Title

  • Display Artist

  • Recording Type: Audio / Video*

  • Release Type: Album, EP, etc.** 

  • Format: Vinyl, CD, Digital, etc.**

  • Parental Advisory

  • Imprint: Label name listed on the product

  • Artists: Includes any contributing artists other than the Display Artist, listed with names, roles and identifiers

*Applies to Recordings only

**Applies to Products only








How it works 

The Musical Rights API accepts JSON-formatted POST requests. We’ll provide tech specs, sample messages and templates to use. 

Submissions for new claims, revised claims and claim terminations will follow the same steps: 


  1. Send a request 

The API accepts POST requests: API calls that initiate additions or edits to Luminate’s rights data. Messages must be in JSON format and include at least one asset with complete claims data.

We accept bulk claims of up to 500 assets per message. For releases (albums, EPs etc), we recommend sending all assets in a single request; each asset must be listed separately by ISRC and ICPN.


  1. Receive a response 

The API will automatically respond to confirm your submission and/or flag issues. Message responses contain 3 sections: 

Success: Confirmation of successful new claims, updated claims and/or terminated claims. Includes a total count and list of assets.


Warnings: Minor data issues that don’t block claims submission, such as unassigned catalog codes and metadata discrepancies.


Failures: Missing or invalid data resulting in rejected claims. This section lists failed claims with itemized errors for each affected asset. These can include missing standard IDs, invalid country codes, unregistered assets or invalid claim types. 


  1. Correct errors and re-submit

Check and correct items flagged as Failures in your original request. 


  1. View claims in CONNECT 

If your claim was successful, you’ll be able to view claims data in the CONNECT platform. Claims information will be visible on the Dashboard for each claimed entity. 








What to expect 

We’ll launch the Musical Rights API later this year, at which point we’ll begin transitioning select rights holders. Expect an announcement and more information in a few months. Your Luminate account representative will share details, tech specs and resources as they become available.

 

During the transition period, we’ll work with all rights holders to address their specific needs, provide onboarding support and take feedback on the new process.


We’ll give ample notice before implementing changes. In the meantime, we’ll continue to accept claims through existing channels. There won’t be any disruption to the submission process for the time being. 







More to know 

Welcome to CONNECT!

Client Support: Find answers and get the help you need

About CONNECT: Platform overview and updates

Migrating from Music Connect: Overview for legacy users





    • Related Articles

    • Musical rights: Ownership and distribution claims

      Musical rights are the legal framework allowing artists, labels and distributors to earn revenue from their work, primarily by licensing musical compositions (publishing) and licensing or selling recordings (distribution). Luminate tracks ownership ...
    • WorksMatch: Claim musical works and recordings

      Identify musical works, enhance repertoires and maximize publishing revenue with WorksMatch, Luminate’s flagship data enrichment product. WorksMatch is a cloud-based tool that facilitates accurate musical asset identification across the digital ...
    • Luminate Developer Hub: API and Snowflake documentation

      Query the CONNECT database or share large quantities of data with the Luminate API and Snowflake data sharing. See below for a brief introduction. But if you’re planning to use these tools, you’ll probably want to go straight to the Luminate ...
    • Migration FAQs: Legacy user questions

      For years, Music Connect has been an essential destination for curious, analytical, data-driven professionals from across the entertainment industry. We’ve already fielded questions about the new CONNECT, such as: Why did you develop a new platform? ...
    • ISRC, ICPN, ISNI: External IDs and product codes

      We attach at least one unique alphanumeric identifier to every musical entity in our database. These include our own Luminate IDs, industry-standard codes like ISRC and ISNI, platform/provider IDs and codes from various music databases. Luminate ...
    • Popular Articles

    • Quickstart Guide: Set up CONNECT in minutes

      Whether you’re a new user or already have a Luminate Data account, here’s how to log in, access the CONNECT platform and start uncovering music insights. Back to Getting Started Quickstart steps If you’re already a Music Connect user, skip to Step 4 ...
    • Troubleshooting guide: Quick fixes to common problems

      If you’ve hit a CONNECT roadblock—access issues, error messages, apparent bugs—don’t despair! There could be a simple solution. Use this guide to narrow down the problem and/or make it easier to explain to Client Support. First, review our best ...
    • Methodology 101: How Luminate collects, models and measures music data

      Luminate tracks music consumption activity. We do this by ingesting reported activity from thousands of data sources. We use that data to construct and maintain a musical entity database. This allows us to attach metadata and activity to artists, ...
    • Glossary: Acronyms, key terms and definitions

      Key terms and acronyms used in CONNECT. Back to Terms and Concepts Back to How It Works A ATD Activity to Date Combined total activity, starting from the earliest year for which CONNECT has complete data and ending with the selected time frame. ATD ...
    • Welcome to CONNECT!

      CONNECT is the music database and analytics platform developed by Luminate to track, measure and visualize music consumption on a global scale. After 30+ years as the music industry’s most trusted source of consumption data, we leveraged our ...