Build your app with one powerful API
Tunearo Enterprise is built API-first. The same infrastructure that powers the dashboard is available to your engineers as documented REST endpoints under /api/public/v1, authenticated with a bearer API key.
Catalog coverage
Create, read, update and delete releases, tracks and artists, plus metadata patches, submission and takedown endpoints.
Bearer API keys
Keys are issued per account with a visible prefix, email-verified reveal, instant freeze if leaked, revocation and last-used tracking.
Webhooks with signed secrets
Register endpoints for release.submitted, approved, rejected, live, takedown_completed and royalties.imported, with automatic retries.
Signed upload URLs
Request short-lived upload URLs for artwork and track audio, then upload directly to storage without proxying files.
Endpoint reference
Every endpoint returns predictable JSON, uses standard HTTP status codes and is scoped to the authenticated account.
Releases
/releasesList releases with status filter, limit and offset pagination./releasesCreate a draft or pending release with genres, territories, services and copyright./releases/{id}Fetch a release with its tracks and resolved artists./releases/{id}Update release fields while it is still editable./releases/{id}Delete a release that has not been delivered./releases/{id}/metadataPatch metadata only, for post-delivery corrections./releases/{id}/submitSubmit the release for review and delivery./releases/{id}/statusPoll approval, rejection reason and live status — no email required./releases/{id}/takedownRequest a takedown across delivered stores./releases/{id}/artwork-upload-urlGet a signed URL to upload cover artwork.Tracks
/releases/{id}/tracksList the tracks on a release./releases/{id}/tracksAdd a track with ISRC, contributors and audio metadata./releases/{id}/tracks/{trackId}Read a single track./releases/{id}/tracks/{trackId}Update track metadata and splits./releases/{id}/tracks/{trackId}Remove a track from the release./releases/{id}/tracks/{trackId}/audio-upload-urlGet a signed URL to upload the master audio file.Artists
/artistsList artists in the account./artistsCreate an artist profile with store identifiers./artists/{id}Read an artist profile./artists/{id}Update artist names and platform links./artists/{id}Delete an artist that is not linked to a release./artists/{id}/oac-requestRequest an Official Artist Channel for the artist./artists/{id}/oac-requestCheck the status of an OAC request.Royalties & webhooks
/royaltiesRead royalty lines across the catalog by period, store and territory./releases/{id}/royaltiesRead royalties for a single release./webhooksList registered webhook endpoints./webhooksRegister an endpoint and receive its signing secret./webhooks/{id}Read one endpoint and its subscribed events./webhooks/{id}Remove an endpoint.Create a release in one request
Send the release, add tracks, request signed upload URLs for artwork and audio, then submit. Territory and service values are validated before anything reaches a store.
Webhook events
curl https://your-domain.com/api/public/v1/releases \
-H "Authorization: Bearer $DISTRODOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Night Signal",
"release_type": "Single",
"artist_name": "Aurora Kane",
"primary_genre": "Electronic",
"release_date": "2026-09-04",
"licensed_territories_include": "WORLD",
"status": "pending"
}'Get sandbox API access
Tell us what you're building and we'll set up keys and documentation for your team.
Get Started