Log In Start for Free

Notes API

Import songs, manage musicians and catalogs, and review royalty registration from your own product.

Apply for Platform API Open the API docs Connect with MCP
$500Monthly Platform API access
$0.60Each song reviewed

What the API does

Songs, musicians, catalogs and reviews in one API

01

Import songs

Bring songs into Notes by ISRC, ISWC, MLC song code or Spotify ID. Each import returns a Notes song ID you can add to any catalog.

  • POST/v1/imports/isrc/{isrc}
  • POST/v1/imports/iswc/{iswc}
  • POST/v1/imports/mlc/{mlc_song_code}
  • POST/v1/imports/spotify/songs/{id}
  • POST/v1/imports/spotify/albums/{id}
  • POST/v1/imports/spotify/artists/{id}
  • POST/v1/imports/spotify/playlists/{id}
  • POST/v1/imports/work
02

Musicians

Search musicians by legal name or IPI before you create one, so each songwriter keeps one identity across catalogs.

  • GET/v1/musicians/search
  • POST/v1/musicians
  • GET/v1/musicians/{id}
03

Catalogs

Create a catalog for a musician, team or company, then add songs to it. Companies can also import and download catalogs as CSV.

  • POST/v1/platforms/catalogs
  • GET/v1/platforms/catalogs
  • POST/v1/catalogs/{id}/songs
  • POST/v1/teams/{id}/catalogs
  • POST/v1/companies/{id}/catalogs/import
  • GET/v1/companies/{id}/catalogs/download
04

Royalty review

Notes reviews each song in the background once it is added, then again on a rolling 30-day cycle. Read a catalog summary, full results or a song’s review history.

  • Registration. A song or recording may be missing from a relevant royalty source.
  • Ownership. A share may be unclaimed, or not represented as expected.
  • Identity. Missing or conflicting identifiers can make a musician harder to match to a song.
  • Recording. A recording and its songwriting may not connect correctly.
  • GET/v1/catalogs/{id}/summary
  • GET/v1/catalogs/{id}
  • GET/v1/catalogs/{id}/songs/{catalog_song_id}/reviews
05

Teams and companies

Create teams, link them to your company and invite Team Members. Available with a Company API key.

  • POST/v1/teams
  • GET/v1/teams/{id}
  • POST/v1/teams/{id}/invites
  • GET/v1/companies/{id}
  • POST/v1/companies/{id}/teams
  • POST/v1/companies/{id}/invites
06

Usage

See how many songs were reviewed each day of a month, so billing never comes as a surprise.

  • GET/v1/platforms/usage
  • GET/v1/companies/{id}/usage

API keys

Choose the key for your setup

Company API

Connect your Notes company account

Connect your company’s Notes data to the tools your team already uses.

Generate a Company API key in your company settings in the Notes app.

Open Notes

Platform API

Offer Notes in your product

Create catalogs for your users, add their songs, and show review results in your own product.

Email api@notes.fm to apply for a Platform API key.

Contact us
Operation Company key Platform key
Import songsYesYes
Create, get or search musiciansYesYes
Add songs to a permitted catalogYesYes
Read catalogs, summaries and review historyYesYes
Create or list platform catalogsNoYes
Create, import or download your company catalogYesNo
Create teams and invite Team MembersYesNo
Read review usageYesYes
Connect with MCPNoYes

Quickstart

From first song to first review

  1. 01

    Find or create a musician

    Search by legal name or IPI. Create a musician only when there is no match.

  2. 02

    Import songs

    Import by ISRC, ISWC, MLC song code or Spotify ID to get each Notes song ID.

  3. 03

    Create a catalog

    Create an empty catalog and keep its ID for future requests.

  4. 04

    Add songs

    Add each song ID with its musician ID. Notes starts reviewing in the background.

  5. 05

    Read the results

    Read the summary or full results, then show the next step in your product.

API examples

Simple JSON. Consistent responses.

Import a songPOST
POST /v1/imports/isrc/USS1Z9900001
Authorization: Bearer notes_live_...

{
  "status": 200,
  "success": true,
  "data": {
    "id": "7d1c2b43-..."
  },
  "timestamp": "2026-09-17T16:00:00.000Z"
}
Open the API docs

Developer details

What to know before you build

Authentication

Send your API key as a Bearer token with each request. Keep it on your server.

Environments

Production keys start with notes_live_. Staging keys start with notes_test_ and work only on staging-api.notes.fm.

Rate limits

Each key can make 120 requests per minute. Requests over the limit return 429.

Responses

Every response uses the same JSON envelope. Lists use offset pagination, up to 100 items per page.

Model Context Protocol

Use the same API key in Cursor or Claude

Notes MCP gives your agent one tool per public API operation. Connect to https://api.notes.fm/mcp with the same platform key you use for REST.

Cursor / Claude
{
  "mcpServers": {
    "notes": {
      "url": "https://api.notes.fm/mcp",
      "headers": {
        "Authorization": "Bearer notes_live_…"
      }
    }
  }
}

Pricing

Predictable API pricing

Platform API access is $500 a month. Each song reviewed is $0.60.

Usage counts the first completed review of each song. Reading results again does not add to usage.

FAQ

Notes API questions

What can the Notes API do?

The Notes API lets you import songs, create and search musicians, build catalogs, read royalty review results and track review usage. Company keys can also manage teams and invite Team Members.

How does royalty review work?

Notes reviews each song in the background once it is added to a catalog, then again on a rolling 30-day cycle. Results flag potential registration, ownership, identity and recording issues.

How much does the Platform API cost?

Platform API access is $500 a month. Each song reviewed is $0.60. Usage counts the first completed review of each song.

What is the difference between Company API and Platform API?

Company API connects a company’s own Notes account to its internal tools. Platform API lets another product offer Notes to its users.

How do I get a Company API key?

Open your company settings in the Notes app and generate the key there.

How do I get a Platform API key?

Email the Notes team at api@notes.fm. Approved integrations receive an environment-specific key.

Are there rate limits?

Each API key can make 120 requests per minute. Requests over the limit return a 429 response.

Can I use the same key in Cursor or Claude?

Yes. Use the same notes_live or notes_test platform key at https://api.notes.fm/mcp. MCP lists public operations only.