Notes Platform API
Music royalties, simplified.
Add songs to a catalog, review their royalty status, and return clear results to your team or customers.
How it works
From catalog entry to royalty review
- 01
Create a catalog
Create a catalog for a musician and keep its Notes ID for future requests.
- 02
Add songs
Import songs by identifier, then add each Notes song ID and musician ID to the catalog.
- 03
Review the catalog
Notes reviews new songs in the background and refreshes the catalog on a rolling 30-day cycle.
- 04
Use the results
Read a catalog summary or full review data, then show the useful next step in your product.
What Notes checks
Clear signals without exposing private review methods
Registration gaps
Signals that a song or recording may be missing from a relevant royalty source.
Ownership gaps
Signals that a share may be unclaimed or not represented as expected.
Identity gaps
Missing or conflicting identifiers that can make it harder to match a musician to a song.
Recording gaps
Signals that a recording and its songwriting information may not connect correctly.
API examples
Simple JSON. Consistent responses.
POST /v1/catalogs/{catalog_id}/songs
Authorization: Bearer notes_live_...
Content-Type: application/json
{
"songs": [
{
"id": "7d1c2b43-...",
"musician_id": "a49f6c21-..."
}
]
}{
"status": 200,
"success": true,
"data": {
"id": "3f84d61a-...",
"name": "Example Catalog",
"status": "complete",
"total_songs": 120,
"songs_with_issues": 14,
"percentage_with_issues": 12,
"recording_issues": 4,
"publishing_issues": 10
},
"timestamp": "2026-09-17T16:00:00.000Z"
}GET /v1/catalogs/{catalog_id}
Authorization: Bearer notes_live_...
{
"status": 200,
"success": true,
"data": {
"id": "3f84d61a-...",
"name": "Example Catalog",
"status": "complete",
"next_review": "2026-10-17T16:00:00.000Z",
"songs": [
{
"id": "7d1c2b43-...",
"catalog_song_id": "e2aa91c8-...",
"title": "Example Song",
"isrcs": ["US-S1Z-99-00001"],
"iswc": "T-123.456.789-0",
"last_reviewed": "2026-09-17T16:00:00.000Z",
"musician": {
"id": "a49f6c21-...",
"legal_name": "Example Musician"
}
}
],
"song_reviews": [
{
"id": "91b04e22-...",
"song_id": "7d1c2b43-...",
"musician_id": "a49f6c21-...",
"status": "completed",
"recording_status": "issue",
"publishing_status": "ok",
"performance_status": "issue"
}
]
},
"timestamp": "2026-09-17T16:00:00.000Z"
}Pricing
Predictable API pricing
Monthly API access is $500. Each song reviewed is $0.50.
FAQ
Notes API questions
What can the Notes API do?
The Notes API lets a platform create catalogs, add songs, and read royalty review results.
What issues does Notes look for?
Notes looks for broad registration, ownership, identity, and recording gaps. The API returns actionable results without exposing private review methods.
How much does the Notes API cost?
Monthly API access is $500. Each song reviewed is $0.50.