Sua marca.
Seu distribuição.
Seu regras.

GET /v1/catalog/rel_8Kd2
Authorization: Bearer ••••••
Accept: application/json

HTTP/2 200 OK
x-request-id: req_8f2a91
{
  "object": "release",
  "id": "rel_8Kd2",
  "title": "Midnight in Lagos",
  "version": "Extended Mix",
  "artist": { "id": "art_2Lp9", "name": "Ayra Nova" },
  "type": "single",
  "genre": "Afrobeats",
  "identifiers": {
    "isrc": "USX9P2418301",
    "upc": "197762148301"
  },
  "tracks": 1,
  "explicit": false,
  "release_date": "2026-06-14",
  "status": "live"
}

GET /v1/supply/rel_8Kd2
Authorization: Bearer ••••••
Accept: application/json

HTTP/2 200 OK
x-request-id: req_3b71d0
{
  "object": "supply_route",
  "release": "rel_8Kd2",
  "deal": { "code": "tonegrid", "model": "white_label" },
  "partner": {
    "id": "prt_4471",
    "name": "northsound",
    "tier": "premium"
  },
  "route": "direct",
  "territories": ["worldwide"],
  "stores": 220,
  "takedowns": 0,
  "status": "active"
}

GET /v1/deliveries?release=rel_8Kd2&limit=3
Authorization: Bearer ••••••
Accept: application/json

HTTP/2 200 OK
x-request-id: req_9c02ef
{
  "object": "list",
  "release": "rel_8Kd2",
  "summary": { "delivered": 220, "pending": 0, "failed": 0 },
  "data": [
    { "dsp": "spotify", "state": "live", "live_at": "2026-06-14T09:21Z" },
    { "dsp": "apple_music", "state": "live", "live_at": "2026-06-14T10:03Z" },
    { "dsp": "youtube_music", "state": "live", "live_at": "2026-06-14T11:47Z" }
  ],
  "has_more": true,
  "state": "live"
}

GET /v1/royalties/rel_8Kd2
Authorization: Bearer ••••••
Accept: application/json

HTTP/2 200 OK
x-request-id: req_5d18aa
{
  "object": "royalty_statement",
  "release": "rel_8Kd2",
  "currency": "USD",
  "period": "2026-05",
  "gross": 6204.18,
  "fees": 1383.91,
  "net_payable": 4820.27,
  "splits": [
    { "payee": "Ayra Nova", "share": 0.70, "amount": 3374.19 },
    { "payee": "northsound", "share": 0.30, "amount": 1446.08 }
  ],
  "next_payout": "2026-07-01",
  "status": "open"
}

GET /v1/analytics/rel_8Kd2?window=24h
Authorization: Bearer ••••••
Accept: application/json

HTTP/2 200 OK
x-request-id: req_a7f330
{
  "object": "analytics_snapshot",
  "release": "rel_8Kd2",
  "window": "24h",
  "streams": { "total": 18244, "lifetime": 1284907 },
  "listeners": 14803,
  "saves": 2117,
  "top_markets": ["NG", "GB", "US"],
  "top_dsp": "spotify",
  "trend": "+23.4%",
  "updated_at": "2026-06-14T12:00Z"
}

GET /v1/users?team=label_77
Authorization: Bearer ••••••
Accept: application/json

HTTP/2 200 OK
x-request-id: req_2e90c4
{
  "object": "team",
  "id": "label_77",
  "name": "Northsound Records",
  "seats": { "used": 14, "max": 25 },
  "sso": { "enabled": true, "provider": "saml" },
  "members": [
    { "id": "usr_01", "role": "owner", "mfa": true },
    { "id": "usr_02", "role": "finance", "mfa": true }
  ],
  "roles": ["owner", "admin", "finance", "viewer"],
  "status": "active"
}

GET /v1/rights/rel_8Kd2
Authorization: Bearer ••••••
Accept: application/json

HTTP/2 200 OK
x-request-id: req_6b44f1
{
  "object": "rights_record",
  "release": "rel_8Kd2",
  "verified": true,
  "masters": { "holder": "northsound", "share": 1.0 },
  "publishing": [
    { "writer": "A. Nova", "ipi": "00831042", "share": 0.60 },
    { "writer": "K. Bassey", "ipi": "00774918", "share": 0.40 }
  ],
  "conflicts": 0,
  "status": "clear"
}

GET /v1/fraud/rel_8Kd2
Authorization: Bearer ••••••
Accept: application/json

HTTP/2 200 OK
x-request-id: req_f93ac1
{
  "object": "fraud_assessment",
  "release": "rel_8Kd2",
  "verdict": "cleared",
  "risk": {
    "level": "low",
    "score": 0.04,
    "confidence": 0.97
  },
  "acr": {
    "match": false,
    "engine": "acrcloud",
    "scanned_dsps": 220
  },
  "signals": ["metadata_ok", "audio_unique", "artist_verified"],
  "flagged": false,
  "reviewed_at": "2026-06-14T09:21:44Z"
}

POST /v1/webhooks
Authorization: Bearer ••••••
Content-Type: application/json
Idempotency-Key: evt_create_01

HTTP/2 201 Created
x-request-id: req_c1d8b2
{
  "object": "webhook_endpoint",
  "id": "wh_3Fa9",
  "url": "https://api.yourbrand.com/hooks",
  "events": [
    "release.live",
    "royalty.posted",
    "fraud.flagged"
  ],
  "api_version": "2026-06-01",
  "active": true,
  "secret": "whsec_••••••••",
  "created_at": "2026-06-14T09:00Z"
}