Nền tảng phân phối nhạc nhãn trắng B2B Thương hiệu của bạn.
Phân phối của bạn.
Luật chơi của bạn.

GET /v1/releases/8f2a91c4-5d18-4aa7-9c02-ef3b71d0a7f3
Authorization: Bearer tgk_••••••
Accept: application/json

HTTP/2 200 OK
x-request-id: req_8f2a91
{
  "release": {
    "uuid": "8f2a91c4-5d18-4aa7-9c02-ef3b71d0a7f3",
    "title": "Midnight in Lagos",
    "type": "single",
    "status": "live",
    "upc": "197762148301",
    "release_date": "2026-06-14",
    "genre": "Afrobeats",
    "language": "en",
    "label": "Northsound Records",
    "copyright_year": 2026,
    "tracks": [
      { "title": "Midnight in Lagos", "position": 1 }
    ],
    "updated_at": "2026-06-14T08:00:00Z"
  }
}

GET /v1/supply-chain/dsps
Authorization: Bearer tgk_••••••
Accept: application/json

HTTP/2 200 OK
x-request-id: req_3b71d0
{
  "success": true,
  "data": {
    "dsps": [
      { "slug": "spotify", "delivery_method": "ddex_sftp_direct", "ddex_ern_version": "4.3" },
      { "slug": "apple-music", "delivery_method": "ddex_sftp_direct", "ddex_ern_version": "4.3" },
      {
        "slug": "youtube-music",
        "delivery_method": "ddex_rest_direct",
        "ddex_ern_version": "4.3"
      }
    ]
  }
}

GET /v1/releases/8f2a91c4-5d18-4aa7-9c02-ef3b71d0a7f3/ddex/deliveries
Authorization: Bearer tgk_••••••
Accept: application/json

HTTP/2 200 OK
x-request-id: req_9c02ef
{
  "success": true,
  "data": {
    "release_id": "8f2a91c4-5d18-4aa7-9c02-ef3b71d0a7f3",
    "deliveries": [
      { "dsp": "spotify", "status": "live", "live_at": "2026-06-14T00:02:11Z" },
      { "dsp": "apple-music", "status": "live", "live_at": "2026-06-14T00:05:48Z" },
      { "dsp": "youtube-music", "status": "live", "live_at": "2026-06-14T00:09:30Z" }
    ]
  }
}

GET /v1/royalties/statements/stmt_202605
Authorization: Bearer tgk_••••••
Accept: application/json

HTTP/2 200 OK
x-request-id: req_5d18aa
{
  "statement": {
    "id": "stmt_202605",
    "period": "2026-05",
    "total_usd": "4820.27",
    "status": "finalized",
    "breakdown": [
      { "dsp": "Spotify", "streams": 812400, "revenue_usd": "3133.18" },
      { "dsp": "Apple Music", "streams": 164900, "revenue_usd": "964.05" },
      { "dsp": "YouTube Music", "streams": 307600, "revenue_usd": "723.04" }
    ]
  }
}

GET /v1/analytics/overview?from=2026-05-01&to=2026-05-31
Authorization: Bearer tgk_••••••
Accept: application/json

HTTP/2 200 OK
x-request-id: req_a7f330
{
  "success": true,
  "message": "Success",
  "data": {
    "period": { "from": "2026-05-01", "to": "2026-05-31" },
    "overview": { "streams": 1284900, "revenue": 4820.27, "listeners": 312044, "saves": 18233 }
  }
}

GET /v1/users?per_page=2
Authorization: Bearer tgk_••••••
Accept: application/json

HTTP/2 200 OK
x-request-id: req_2e90c4
{
  "success": true,
  "data": [
    { "full_name": "Ada Okoye", "role": "label_admin", "status": "active", "email_verified": 1 },
    { "full_name": "Kemi Bassey", "role": "staff", "status": "active", "email_verified": 1 }
  ],
  "meta": { "total": 14, "per_page": 2, "current_page": 1, "last_page": 7 }
}

GET /v1/releases/8f2a91c4-5d18-4aa7-9c02-ef3b71d0a7f3/rights
Authorization: Bearer tgk_••••••
Accept: application/json

HTTP/2 200 OK
x-request-id: req_6b44f1
{
  "success": true,
  "data": {
    "streaming": true,
    "download": true,
    "ugc": true,
    "sync": false,
    "p_line": "(P) 2026 Northsound Records",
    "c_line": "(C) 2026 Northsound Records",
    "copyright_year": 2026,
    "mech_license_held": true,
    "iswc": "T-123456789-0",
    "pro_affiliation": "ASCAP",
    "sample_clearance_status": "cleared",
    "ai_disclosure": "none"
  }
}

POST /v1/ingestion/ddex
Authorization: Bearer tgk_••••••
Content-Type: application/xml

HTTP/2 202 Accepted
x-request-id: req_f93ac1
{
  "success": true,
  "message": "DDEX bundle received.",
  "data": {
    "ingestion_job_id": "7a3c5e90-2b1f-4c68-a4d7-51e0c9b3d910",
    "state": "received",
    "ddex_message_id": "NORTHSOUND-MSG-2026-06-10-001",
    "ddex_ern_version": "4.3"
  }
}

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

HTTP/2 201 Created
x-request-id: req_c1d8b2
{
  "success": true,
  "data": {
    "uuid": "9a8b7c6d-5e4f-4a3b-9c2d-1e0fc1d0a9b8",
    "name": "Production hook",
    "url": "https://api.yourbrand.com/hooks",
    "events": ["release.dsp.*.live", "ingestion.*", "royalty_statement.ready"],
    "is_active": true,
    "secret": "tgwhsec_••••••••"
  }
}