API Reference

REST API for Music Attribution

A single base URL, bearer-token authentication, and JSON request/response bodies. Submit generated audio, query your indexed catalog, and retrieve attribution evidence in one API call.

Base URL 
https://api.wearemuiscalai.com/v1

# Authentication
Authorization: Bearer {API_KEY}

# Content type
Content-Type: application/json

Endpoints

Available API Endpoints

Method Endpoint Description Status
POST /v1/attribute Submit a generated audio URL for attribution. Returns ranked ISRC matches with confidence scores. v1
POST /v1/catalog/ingest Bulk-ingest ISRC-keyed catalog entries for indexing. Accepts audio URLs and metadata JSON. v1
GET /v1/catalog/{catalog_id} Retrieve catalog index status and ISRC coverage statistics. v1
PUT /v1/catalog/{catalog_id}/entry Add or update a single ISRC entry in an existing catalog without full re-index. v1
DELETE /v1/catalog/{catalog_id}/entry/{isrc} Remove a specific ISRC from the catalog index. v1
GET /v1/jobs/{job_id} Poll an asynchronous attribution or ingest job by ID for status and results. v1
GET /v1/usage Retrieve current billing period query count and rate limit status for your API key. v1

Request Reference

POST /v1/attribute

Request body

{
  "audio_url":   "string (required)",
  "catalog_id":  "string (required)",
  "threshold":   0.40,   // 0.0 to 1.0
  "max_matches": 10,    // default 5
  "stems":       "all"   // or array
}

Audio format support

  • WAV (16-bit, 44.1 kHz, stereo)
  • MP3 (128 kbps minimum)
  • FLAC (lossless, any sample rate)
  • Max duration: 10 minutes per query

Response body

{
  "job_id":    "job_bx9z2k",
  "status":   "complete",
  "latency_ms": 11,
  "matches": [
    {
      "isrc":         "USAT22304812",
      "score":        0.87,
      "rights_holder":"Meridian Songs",
      "stem_match":   "vocal_lead",
      "track_title":  "Midnight Signal"
    }
  ]
}

Authentication

API Keys and Rate Limits

Bearer Token Authentication

All API calls require an Authorization header with your bearer token. Keys are scoped to a single catalog namespace and can be rotated from the dashboard at any time.

Volume Limits by Plan

Pilot: 5,000 track identifications per month. Publisher: 25,000 per month with batch endpoint access. Network: custom volume with burst allowances. Remaining quota is returned in each response header.

Errors and Status Codes

Standard HTTP Status Codes

Code Meaning Common cause
200 OK Attribution complete. Matches array may be empty if no results exceed threshold.
202 Accepted Attribution job queued (async mode for long audio). Poll /v1/jobs/{job_id} for results.
400 Bad Request Missing required field, invalid audio URL, or unsupported format.
401 Unauthorized Missing or invalid bearer token.
429 Too Many Requests Monthly query limit reached. Upgrade plan or wait for next billing cycle.
500 Server Error Processing failure. Contact [email protected] with job_id.

Get Your API Key

Request early access to start making attribution queries against your catalog.

Request Access Talk to Engineering