{"openapi":"3.0.3","info":{"title":"WBBT Distributor API","version":"1.0.0","description":"Programmatic music distribution for label/distributor partners.\n\nAuthenticate with `Authorization: Bearer wbbt_sk_live_…`. Every key carries a set of\nscopes; a call outside them returns 403 `INSUFFICIENT_SCOPE` naming the scope required.\nCall `GET /me` to see what a key holds.\n\nEndpoints that act on one of your end users take `X-Subaccount-Id`, which accepts either\nthe WBBT sub-account id or the `externalId` you assigned."},"servers":[{"url":"/api/v1"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"Use your API key: Authorization: Bearer wbbt_sk_live_…"}},"parameters":{"SubaccountHeader":{"name":"X-Subaccount-Id","in":"header","required":true,"schema":{"type":"string"},"description":"WBBT sub-account id or your externalId."}},"schemas":{"Error":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Human-readable explanation."},"code":{"type":"string","description":"Stable machine-readable code. Branch on this, not on the message."},"required":{"type":"string","description":"On INSUFFICIENT_SCOPE: the scope this call needs."},"granted":{"type":"array","items":{"type":"string"},"description":"On INSUFFICIENT_SCOPE: what the key does hold."},"retryAfter":{"type":"integer","nullable":true,"description":"On RATE_LIMITED: seconds to wait."}}},"Me":{"type":"object","properties":{"partner":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"}}},"mode":{"type":"string","enum":["live","test"]},"plan":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"entitlement":{"type":"object","properties":{"active":{"type":"boolean"},"autoApprove":{"type":"boolean"},"subscriptionStatus":{"type":"string","nullable":true}}},"limits":{"type":"object","properties":{"requestsPerMinute":{"type":"integer","nullable":true},"monthlyReleaseLimit":{"type":"integer","nullable":true,"description":"null means uncapped."},"subAccounts":{"type":"integer"},"maxSubAccounts":{"type":"integer","nullable":true,"description":"null means uncapped."}}},"scopes":{"type":"array","items":{"type":"string","enum":["releases:read","releases:write","subaccounts:read","subaccounts:write","artists:read","artists:write","uploads:read","uploads:write","payment-methods:read","payment-methods:write","withdrawals:read","withdrawals:write","earnings:read","streams:read","webhooks:write"]}},"commercial":{"$ref":"#/components/schemas/CommercialAccess"}}},"Subaccount":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"externalId":{"type":"string","nullable":true},"status":{"type":"string","enum":["active","deactivated"]},"createdAt":{"type":"string"}},"required":["id","externalId","name","email","status","createdAt"]},"SubaccountCreate":{"type":"object","required":["name","externalId"],"properties":{"email":{"type":"string","format":"email"},"name":{"type":"string"},"externalId":{"type":"string","description":"Your own identifier. Usable anywhere a sub-account id is."}}},"Artist":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"user_id":{"type":"string"},"role":{"type":"string"},"spotify_url":{"type":"string","nullable":true},"apple_id":{"type":"string","nullable":true}},"required":["id","name"]},"ArtistCreate":{"type":"object","properties":{"name":{"type":"string"},"legalName":{"type":"string"},"role":{"type":"string"},"spotifyUrl":{"type":"string"},"appleId":{"type":"string"}},"required":["name"]},"UploadCreate":{"type":"object","required":["filename","data"],"properties":{"filename":{"type":"string"},"data":{"type":"string","description":"Base64 file contents, with or without a data: prefix."},"purpose":{"type":"string","enum":["audio","cover","document"]}}},"Upload":{"type":"object","properties":{"fileId":{"type":"string"},"url":{"type":"string"}}},"Track":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"version":{"type":"string","nullable":true},"fileUrl":{"type":"string","nullable":true},"isrc":{"type":"string","nullable":true},"iswc":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"isExplicit":{"type":"boolean"},"lyrics":{"type":"string","nullable":true},"aiUsage":{"type":"string","nullable":true},"compositionType":{"type":"string","nullable":true},"genre":{"type":"string","nullable":true},"subGenre":{"type":"string","nullable":true},"isInstrumental":{"type":"boolean"},"copyrightType":{"type":"string","nullable":true},"previewStartTime":{"type":"number","nullable":true},"duration":{"type":"number","nullable":true},"artists":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"role":{"type":"string"},"legalName":{"type":"string","nullable":true},"sharePercent":{"type":"number"},"spotifyUrl":{"type":"string"},"appleId":{"type":"string"},"soundcloudUrl":{"type":"string"}},"required":["name","role"]}},"writers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"legalName":{"type":"string","nullable":true},"role":{"type":"string"},"share":{"type":"number","nullable":true}},"required":["name","role"]}},"splits":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"},"sharePercent":{"type":"number"}},"required":["email","sharePercent"]}}},"required":["id","title","isExplicit","artists","writers","splits"]},"ReleaseCreate":{"type":"object","required":["title","type","genre"],"properties":{"title":{"type":"string"},"type":{"type":"string","enum":["Single","EP","Album"]},"genre":{"type":"string"},"subGenre":{"type":"string"},"language":{"type":"string"},"releaseDate":{"type":"string","format":"date"},"coverUrl":{"type":"string"},"upc":{"type":"string","nullable":true},"mainArtist":{"type":"string"},"recordLabel":{"type":"string","description":"The \"Provided to YouTube by\" credit."},"selectedStores":{"type":"array","items":{"type":"string"},"description":"Store ids from /lookups/stores."},"tracks":{"type":"array","items":{"$ref":"#/components/schemas/TrackCreate"}},"cLine":{"type":"string"},"pLine":{"type":"string"},"cYear":{"type":"integer"},"pYear":{"type":"integer"},"confirmations":{"type":"object"},"territory":{"type":"string"},"territoryCountries":{"type":"array","items":{"type":"string"}},"publishingOptIn":{"type":"boolean"}},"description":"Draft creation requires title, type and genre. Before submission validate the complete stored release: mainArtist, releaseDate, coverUrl, cLine, pLine, stores, tracks with fileUrl, primary artist, producer, composer legal names and performer credits."},"Release":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"status":{"type":"string","description":"Current pipeline state, including draft, pending review, editing and takedown states."},"genre":{"type":"string","nullable":true},"releaseDate":{"type":"string","nullable":true},"upc":{"type":"string","nullable":true},"coverUrl":{"type":"string","nullable":true},"selectedStores":{"type":"array","items":{"type":"string"}},"tracks":{"type":"array","items":{"$ref":"#/components/schemas/Track"}},"userId":{"type":"string"},"type":{"type":"string","nullable":true},"subGenre":{"type":"string","nullable":true},"createdDate":{"type":"string"},"mainArtist":{"type":"string","nullable":true},"recordLabel":{"type":"string","nullable":true},"cLine":{"type":"string","nullable":true},"pLine":{"type":"string","nullable":true},"cYear":{"oneOf":[{"type":"string"},{"type":"integer"}],"nullable":true},"pYear":{"oneOf":[{"type":"string"},{"type":"integer"}],"nullable":true},"originalReleaseDate":{"type":"string","nullable":true},"territory":{"type":"string","nullable":true},"territoryCountries":{"type":"array","items":{"type":"string"}},"publishingOptIn":{"type":"boolean"},"distributedBefore":{"type":"boolean"},"smartLink":{"type":"string","nullable":true},"presave":{"type":"object","nullable":true},"hasPendingEdit":{"type":"boolean"},"lastEdit":{"type":"object","nullable":true},"rejectionReason":{"type":"string","nullable":true},"takedownRequestedAt":{"type":"string","nullable":true},"labelId":{"type":"string","nullable":true},"labelName":{"type":"string","nullable":true},"monetization":{"type":"object"},"documents":{"type":"array","items":{"type":"string"}},"confirmations":{"type":"object"}},"required":["id","userId","title","status","tracks","createdDate"]},"ReleaseList":{"type":"object","properties":{"releases":{"type":"array","items":{"$ref":"#/components/schemas/Release"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"hasMore":{"type":"boolean"}},"required":["releases","total","limit","offset","hasMore"]},"ReleaseStatus":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"rejectionReason":{"type":"string","nullable":true},"liveAt":{"type":"string","nullable":true}}},"Quota":{"type":"object","properties":{"unlimited":{"type":"boolean"},"used":{"type":"integer"},"monthlyReleaseLimit":{"type":"integer"},"remaining":{"type":"integer"},"period":{"type":"string","enum":["monthly"]},"resetsAt":{"type":"string"}},"required":["unlimited","used","period","resetsAt"]},"Earnings":{"type":"object","properties":{"currency":{"type":"string"},"lifetimeTotal":{"type":"number"},"byMonth":{"type":"array","items":{"type":"object","properties":{"month":{"type":"string"},"amount":{"type":"number"},"streams":{"type":"number"},"downloads":{"type":"number"}},"required":["month","amount","streams","downloads"]}}},"required":["currency","lifetimeTotal","byMonth"]},"WebhookEndpoint":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"string"},"secret":{"type":"string"}},"required":["id","url","events"]},"WebhookEndpointCreate":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"events":{"type":"array","items":{"type":"string"},"description":"Omit for every event."}}},"TrackCreate":{"type":"object","properties":{"title":{"type":"string"},"version":{"type":"string","nullable":true},"fileUrl":{"type":"string","nullable":true},"isrc":{"type":"string","nullable":true},"iswc":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"isExplicit":{"type":"boolean"},"lyrics":{"type":"string","nullable":true},"aiUsage":{"type":"string","nullable":true},"compositionType":{"type":"string","nullable":true},"genre":{"type":"string","nullable":true},"subGenre":{"type":"string","nullable":true},"isInstrumental":{"type":"boolean"},"copyrightType":{"type":"string","nullable":true},"previewStartTime":{"type":"number","nullable":true},"duration":{"type":"number","nullable":true},"artists":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"role":{"type":"string"},"legalName":{"type":"string","nullable":true},"sharePercent":{"type":"number"},"spotifyUrl":{"type":"string"},"appleId":{"type":"string"},"soundcloudUrl":{"type":"string"}},"required":["name","role"]}},"writers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"legalName":{"type":"string","nullable":true},"role":{"type":"string"},"share":{"type":"number","nullable":true}},"required":["name","role"]}},"splits":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"},"sharePercent":{"type":"number"}},"required":["email","sharePercent"]}}},"required":[]},"Metrics":{"type":"object","properties":{"streams":{"type":"number"},"previousStreams":{"type":"number"},"skips":{"type":"number","nullable":true},"skipRate":{"type":"number","nullable":true},"skipCoverage":{"type":"number","nullable":true},"changeRate":{"type":"number","nullable":true},"dailyAverage":{"type":"number"}},"required":["streams","previousStreams","skips","skipRate","skipCoverage","changeRate","dailyAverage"]},"StreamSummary":{"type":"object","properties":{"source":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"latestPlayDate":{"type":"string","nullable":true},"fetchedAt":{"type":"string","nullable":true},"days":{"type":"integer"},"platformNames":{"type":"array","items":{"type":"string"}},"currentComplete":{"type":"boolean"},"previousComplete":{"type":"boolean"},"conflictRows":{"type":"integer"},"ambiguousIsrcs":{"type":"array","items":{"type":"string"}},"importedDays":{"type":"integer"},"streams":{"type":"number"},"previousStreams":{"type":"number"},"skips":{"type":"number","nullable":true},"skipRate":{"type":"number","nullable":true},"skipCoverage":{"type":"number","nullable":true},"changeRate":{"type":"number","nullable":true},"dailyAverage":{"type":"number"},"territoriesAvailable":{"type":"boolean"}},"required":["source","from","to","latestPlayDate","fetchedAt","days","platformNames","currentComplete","previousComplete","conflictRows","ambiguousIsrcs","importedDays","streams","previousStreams","skips","skipRate","skipCoverage","changeRate","dailyAverage","territoriesAvailable"]},"StreamTrack":{"type":"object","properties":{"isrc":{"type":"string"},"trackId":{"type":"string"},"title":{"type":"string"},"releaseTitle":{"type":"string"},"artist":{"type":"string"},"streams":{"type":"number"},"previousStreams":{"type":"number"},"skips":{"type":"number","nullable":true},"skipRate":{"type":"number","nullable":true},"skipCoverage":{"type":"number","nullable":true},"changeRate":{"type":"number","nullable":true},"dailyAverage":{"type":"number"},"platforms":{"type":"array","items":{"type":"object","properties":{"dsp":{"type":"string"},"streams":{"type":"number"},"previousStreams":{"type":"number"},"skips":{"type":"number","nullable":true},"skipRate":{"type":"number","nullable":true},"skipCoverage":{"type":"number","nullable":true},"changeRate":{"type":"number","nullable":true},"dailyAverage":{"type":"number"}},"required":["dsp","streams","previousStreams","skips","skipRate","skipCoverage","changeRate","dailyAverage"]}},"releaseId":{"type":"string"}},"required":["isrc","trackId","title","releaseTitle","artist","streams","previousStreams","skips","skipRate","skipCoverage","changeRate","dailyAverage","platforms"]},"StreamRelease":{"type":"object","properties":{"releaseId":{"type":"string"},"title":{"type":"string"},"trackCount":{"type":"integer"},"streams":{"type":"number"},"previousStreams":{"type":"number"},"skips":{"type":"number","nullable":true},"skipRate":{"type":"number","nullable":true},"skipCoverage":{"type":"number","nullable":true},"changeRate":{"type":"number","nullable":true},"dailyAverage":{"type":"number"}},"required":["releaseId","title","trackCount","streams","previousStreams","skips","skipRate","skipCoverage","changeRate","dailyAverage"]},"StreamDay":{"type":"object","properties":{"date":{"type":"string"},"streams":{"type":"number","nullable":true},"previousStreams":{"type":"number","nullable":true}},"required":["date","streams","previousStreams"],"additionalProperties":{"type":"number","nullable":true}},"StreamTerritory":{"type":"object","properties":{"territory":{"type":"string"},"streams":{"type":"number"},"share":{"type":"number"}},"required":["territory","streams","share"]},"Territories":{"type":"object","properties":{"from":{"type":"string","nullable":true},"to":{"type":"string","nullable":true},"fetchedAt":{"type":"string","nullable":true},"rows":{"type":"array","items":{"$ref":"#/components/schemas/StreamTerritory"}},"totalStreams":{"type":"number"}},"required":["from","to","fetchedAt","rows","totalStreams"]},"StreamReport":{"type":"object","properties":{"source":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"latestPlayDate":{"type":"string","nullable":true},"fetchedAt":{"type":"string","nullable":true},"days":{"type":"integer"},"platformNames":{"type":"array","items":{"type":"string"}},"currentComplete":{"type":"boolean"},"previousComplete":{"type":"boolean"},"conflictRows":{"type":"integer"},"ambiguousIsrcs":{"type":"array","items":{"type":"string"}},"importedDays":{"type":"integer"},"streams":{"type":"number"},"previousStreams":{"type":"number"},"skips":{"type":"number","nullable":true},"skipRate":{"type":"number","nullable":true},"skipCoverage":{"type":"number","nullable":true},"changeRate":{"type":"number","nullable":true},"dailyAverage":{"type":"number"},"territoriesAvailable":{"type":"boolean"},"dailyTotals":{"type":"array","items":{"$ref":"#/components/schemas/StreamDay"}},"dspTotals":{"type":"array","items":{"type":"object","properties":{"dsp":{"type":"string"},"streams":{"type":"number"},"previousStreams":{"type":"number"},"skips":{"type":"number","nullable":true},"skipRate":{"type":"number","nullable":true},"skipCoverage":{"type":"number","nullable":true},"changeRate":{"type":"number","nullable":true},"dailyAverage":{"type":"number"}},"required":["dsp","streams","previousStreams","skips","skipRate","skipCoverage","changeRate","dailyAverage"]}},"tracks":{"type":"array","items":{"$ref":"#/components/schemas/StreamTrack"}},"territories":{"$ref":"#/components/schemas/Territories"},"rows":{"type":"array","items":{"type":"object"}},"releases":{"type":"array","items":{"$ref":"#/components/schemas/StreamRelease"}}},"required":["source","from","to","latestPlayDate","fetchedAt","days","platformNames","currentComplete","previousComplete","conflictRows","ambiguousIsrcs","importedDays","streams","previousStreams","skips","skipRate","skipCoverage","changeRate","dailyAverage","territoriesAvailable","dailyTotals","dspTotals","tracks","territories","rows"]},"Success":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]},"Validation":{"type":"object","properties":{"valid":{"type":"boolean"},"errors":{"type":"array","items":{"type":"string"}}},"required":["valid","errors"]},"CommercialAccess":{"type":"object","properties":{"family":{"type":"string","enum":["API","WHITE_LABEL"]},"agreementId":{"type":"string","nullable":true},"status":{"type":"string"},"accessMode":{"type":"string","enum":["FULL","READ_ONLY","NONE"]},"allowed":{"type":"boolean"},"readOnly":{"type":"boolean"},"limits":{"type":"object","additionalProperties":{"type":"integer","nullable":true}},"features":{"type":"array","items":{"type":"string"}},"periodEnd":{"type":"string","nullable":true},"graceEndsAt":{"type":"string","nullable":true},"usage":{"type":"object","additionalProperties":{"type":"number"}},"resetsAt":{"type":"string"},"period":{"type":"string","enum":["monthly"]}},"required":["family","agreementId","status","accessMode","allowed","readOnly","limits","features","periodEnd","graceEndsAt"]},"PaymentMethod":{"type":"object","properties":{"id":{"type":"string"},"user_id":{"type":"string"},"type":{"type":"string","enum":["IBAN","PAYPAL","WISE","PAYONEER"]},"bank_name":{"type":"string","nullable":true},"account_holder":{"type":"string","nullable":true},"iban":{"type":"string","nullable":true},"swift_bic":{"type":"string","nullable":true},"paypal_email":{"type":"string","nullable":true},"wise_email":{"type":"string","nullable":true},"payoneer_email":{"type":"string","nullable":true},"is_default":{"type":"integer"},"created_at":{"type":"string"}},"required":["id","user_id","type","bank_name","account_holder","iban","swift_bic","paypal_email","wise_email","payoneer_email","is_default","created_at"]},"Withdrawal":{"type":"object","properties":{"id":{"type":"string"},"user_id":{"type":"string"},"amount":{"type":"number"},"method":{"type":"string"},"details":{"type":"string"},"status":{"type":"string"},"note":{"type":"string","nullable":true},"requested_at":{"type":"string"},"processed_at":{"type":"string","nullable":true},"receipt_url":{"type":"string","nullable":true}},"required":["id","user_id","amount","method","details","status","requested_at"]}},"responses":{"Unauthorized":{"description":"NO_API_KEY, INVALID_API_KEY or KEY_EXPIRED.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"PaymentRequired":{"description":"SUBSCRIPTION_INACTIVE, or READ_ONLY_GRACE on a write during an enterprise grace period.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"INSUFFICIENT_SCOPE, ACCOUNT_SUSPENDED or API_SUSPENDED.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"RATE_LIMITED. Honour the Retry-After header.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"security":[{"ApiKeyAuth":[]}],"paths":{"/me":{"get":{"summary":"Current partner, entitlement, limits and this key’s scopes","security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Me"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__me","tags":["me"]}},"/lookups/{kind}":{"get":{"summary":"Reference data","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["genres","stores","languages","performer-roles","contributor-roles","countries"]}}],"responses":{"200":{"description":"OK","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__lookups_kind_","tags":["lookups"]}},"/subaccounts":{"get":{"summary":"List sub-accounts","description":"Requires the `subaccounts:read` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":""},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":""}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"subaccounts":{"type":"array","items":{"$ref":"#/components/schemas/Subaccount"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}},"required":["subaccounts","total","limit","offset"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__subaccounts","tags":["subaccounts"]},"post":{"summary":"Create a sub-account","description":"Requires the `subaccounts:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubaccountCreate"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"subaccount":{"$ref":"#/components/schemas/Subaccount"}},"required":["subaccount"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"post__subaccounts","tags":["subaccounts"]}},"/subaccounts/{id}":{"get":{"summary":"Get a sub-account","description":"Requires the `subaccounts:read` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"subaccount":{"$ref":"#/components/schemas/Subaccount"}},"required":["subaccount"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__subaccounts_id_","tags":["subaccounts"]},"patch":{"summary":"Update a sub-account","description":"Requires the `subaccounts:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"subaccount":{"$ref":"#/components/schemas/Subaccount"}},"required":["subaccount"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","format":"email"},"name":{"type":"string"},"externalId":{"type":"string","description":"Your own identifier. Usable anywhere a sub-account id is."}}}}}},"operationId":"patch__subaccounts_id_","tags":["subaccounts"]}},"/subaccounts/{id}/deactivate":{"post":{"summary":"Deactivate a sub-account","description":"Requires the `subaccounts:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"subaccount":{"$ref":"#/components/schemas/Subaccount"}},"required":["subaccount"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"post__subaccounts_id_deactivate","tags":["subaccounts"]}},"/artists":{"get":{"summary":"List a sub-account’s artists","description":"Requires the `artists:read` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"artists":{"type":"array","items":{"$ref":"#/components/schemas/Artist"}}},"required":["artists"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__artists","tags":["artists"]},"post":{"summary":"Create an artist","description":"Requires the `artists:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtistCreate"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"artist":{"$ref":"#/components/schemas/Artist"}},"required":["artist"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"post__artists","tags":["artists"]}},"/artists/{id}":{"patch":{"summary":"Update an artist","description":"Requires the `artists:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"artist":{"$ref":"#/components/schemas/Artist"}},"required":["artist"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"legalName":{"type":"string"},"role":{"type":"string"},"spotifyUrl":{"type":"string"},"appleId":{"type":"string"}},"required":[]}}}},"operationId":"patch__artists_id_","tags":["artists"]},"delete":{"summary":"Delete an artist","description":"Requires the `artists:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Success"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"delete__artists_id_","tags":["artists"]},"get":{"summary":"Artist profile and platform mapping","description":"Requires the artists:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"artist":{"$ref":"#/components/schemas/Artist"}},"required":["artist"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__artists_id_","tags":["artists"]}},"/uploads":{"post":{"summary":"Upload audio or cover art (base64)","description":"Requires the `uploads:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadCreate"}},"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"},"purpose":{"type":"string","enum":["audio","cover","document"]}},"required":["file"]}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Upload"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"post__uploads","tags":["uploads"]}},"/releases":{"get":{"summary":"List releases","description":"Requires the `releases:read` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":""},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":""},{"name":"status","in":"query","schema":{"type":"string"},"description":"Exact distribution status."},{"name":"type","in":"query","schema":{"type":"string","enum":["Single","EP","Album"]},"description":""},{"name":"q","in":"query","schema":{"type":"string"},"description":"Literal substring of the release title; wildcard characters are escaped."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseList"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__releases","tags":["releases"]},"post":{"summary":"Create a DRAFT release","description":"Requires the `releases:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseCreate"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"release":{"$ref":"#/components/schemas/Release"}},"required":["release"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"post__releases","tags":["releases"]}},"/releases/{id}":{"get":{"summary":"Get a release","description":"Requires the `releases:read` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"release":{"$ref":"#/components/schemas/Release"}},"required":["release"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__releases_id_","tags":["releases"]},"patch":{"summary":"Update a DRAFT release","description":"Requires the `releases:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"release":{"$ref":"#/components/schemas/Release"}},"required":["release"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"title":{"type":"string"},"type":{"type":"string","enum":["Single","EP","Album"]},"genre":{"type":"string"},"subGenre":{"type":"string"},"language":{"type":"string"},"releaseDate":{"type":"string","format":"date"},"coverUrl":{"type":"string"},"upc":{"type":"string","nullable":true},"mainArtist":{"type":"string"},"recordLabel":{"type":"string","description":"The \"Provided to YouTube by\" credit."},"selectedStores":{"type":"array","items":{"type":"string"},"description":"Store ids from /lookups/stores."},"tracks":{"type":"array","items":{"$ref":"#/components/schemas/TrackCreate"}},"cLine":{"type":"string"},"pLine":{"type":"string"},"cYear":{"type":"integer"},"pYear":{"type":"integer"},"confirmations":{"type":"object"},"territory":{"type":"string"},"territoryCountries":{"type":"array","items":{"type":"string"}},"publishingOptIn":{"type":"boolean"}},"description":"Draft creation requires title, type and genre. Before submission validate the complete stored release: mainArtist, releaseDate, coverUrl, cLine, pLine, stores, tracks with fileUrl, primary artist, producer, composer legal names and performer credits."}}}},"operationId":"patch__releases_id_","tags":["releases"]},"delete":{"summary":"Delete a draft","description":"Requires the releases:write scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Success"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"delete__releases_id_","tags":["releases"]}},"/releases/{id}/status":{"get":{"summary":"Release status","description":"Requires the `releases:read` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseStatus"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__releases_id_status","tags":["releases"]}},"/releases/{id}/activity":{"get":{"summary":"Release activity log","description":"Requires the `releases:read` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"activity":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string"},"fromStatus":{"type":"string","nullable":true},"toStatus":{"type":"string","nullable":true},"reason":{"type":"string","nullable":true},"createdAt":{"type":"string"}},"required":["action","fromStatus","toStatus","reason","createdAt"]}}},"required":["activity"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__releases_id_activity","tags":["releases"]}},"/releases/{id}/submit":{"post":{"summary":"Submit a DRAFT for review","description":"Requires the `releases:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"release":{"$ref":"#/components/schemas/Release"}},"required":["release"]},{"type":"object","properties":{"test":{"type":"boolean"},"wouldSubmit":{"type":"boolean"},"message":{"type":"string"}},"required":["test","wouldSubmit","message"]}]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"post__releases_id_submit","tags":["releases"]}},"/releases/{id}/edit-request":{"post":{"summary":"Propose an edit to a live release","description":"Requires the `releases:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"202":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"status":{"type":"string"},"summary":{"type":"array","items":{"type":"string"}}},"required":["success","status","summary"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseCreate"}}}},"operationId":"post__releases_id_edit_request","tags":["releases"]}},"/releases/{id}/takedown":{"post":{"summary":"Request a takedown","description":"Requires the `releases:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"success":{"type":"boolean"},"status":{"type":"string"}},"required":["success","status"]},{"type":"object","properties":{"test":{"type":"boolean"},"wouldRequestTakedown":{"type":"boolean"}},"required":["test","wouldRequestTakedown"]}]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"post__releases_id_takedown","tags":["releases"]}},"/streams":{"get":{"summary":"Stream reports for one sub-account or a page of sub-accounts","description":"With X-Subaccount-Id returns the artist report. Without it returns paginated reports and totals for that page only (totalsScope=page).","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"First play date. Defaults to the whole reported history."},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"Last play date. Defaults to the most recent day reported."},{"name":"isrc","in":"query","schema":{"type":"string"},"description":"Narrow to one recording."},{"name":"dsp","in":"query","schema":{"type":"string"},"description":"Narrow to one platform, e.g. Spotify."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":""},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":""}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/StreamReport"},{"type":"object","properties":{"subaccounts":{"type":"integer"},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"totalsScope":{"type":"string","enum":["page"]},"from":{"type":"string","nullable":true},"to":{"type":"string","nullable":true},"totals":{"type":"object","properties":{"streams":{"type":"number"},"skips":{"type":"number"},"skipRate":{"type":"number","nullable":true}},"required":["streams","skips","skipRate"]},"reports":{"type":"array","items":{"$ref":"#/components/schemas/StreamReport"}}},"required":["subaccounts","total","limit","offset","totalsScope","from","to","totals","reports"]}]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__streams","tags":["streams"]}},"/earnings":{"get":{"summary":"Sub-account earnings by month","description":"Requires the `earnings:read` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Earnings"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__earnings","tags":["earnings"]}},"/earnings/releases/{id}":{"get":{"summary":"Per-release revenue by channel","description":"Requires the `earnings:read` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"releaseId":{"type":"string"},"currency":{"type":"string","nullable":true},"total":{"type":"number","nullable":true},"totalsByCurrency":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string"},"total":{"type":"number"}},"required":["currency","total"]}},"byChannel":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","nullable":true},"currency":{"type":"string","nullable":true},"units":{"type":"number"},"amount":{"type":"number"}},"required":["channel","currency","units","amount"]}},"amountBasis":{"type":"string"}},"required":["releaseId","currency","total","totalsByCurrency","byChannel","amountBasis"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__earnings_releases_id_","tags":["earnings"]}},"/quota":{"get":{"summary":"Partner monthly release quota","security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quota"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__quota","tags":["quota"]}},"/webhook-endpoints":{"get":{"summary":"List webhook endpoints","description":"Requires the `webhooks:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoints":{"type":"array","items":{"type":"object"}}},"required":["endpoints"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__webhook_endpoints","tags":["webhook-endpoints"]},"post":{"summary":"Register a webhook endpoint","description":"Requires the `webhooks:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointCreate"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"post__webhook_endpoints","tags":["webhook-endpoints"]}},"/webhook-endpoints/{id}":{"delete":{"summary":"Delete a webhook endpoint","description":"Requires the `webhooks:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Success"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"delete__webhook_endpoints_id_","tags":["webhook-endpoints"]},"patch":{"summary":"Update delivery URL, subscriptions or status","description":"Requires the webhooks:write scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"status":{"type":"string"}},"required":["id","url","status"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"string","enum":["active","disabled"]},"events":{"type":"array","items":{"type":"string"}}},"required":[]}}}},"operationId":"patch__webhook_endpoints_id_","tags":["webhook-endpoints"]}},"/webhook-endpoints/{id}/test":{"post":{"summary":"Send a test ping","description":"Requires the `webhooks:write` scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"status":{"type":"integer"},"error":{"type":"string"}},"required":["ok"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"post__webhook_endpoints_id_test","tags":["webhook-endpoints"]}},"/subaccounts/{id}/reactivate":{"post":{"summary":"Reactivate a partner-deactivated account","description":"Requires the subaccounts:write scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"status":{"type":"string"}},"required":["success","status"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"post__subaccounts_id_reactivate","tags":["subaccounts"]}},"/releases/validate":{"post":{"summary":"Validate all DSP submission requirements","description":"Requires the releases:write scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Validation"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"DSP requirements are not satisfied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Validation"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseCreate"}}}},"operationId":"post__releases_validate","tags":["releases"]}},"/releases/{id}/tracks":{"get":{"summary":"List tracks on a release","description":"Requires the releases:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"tracks":{"type":"array","items":{"$ref":"#/components/schemas/Track"}}},"required":["tracks"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__releases_id_tracks","tags":["releases"]}},"/releases/{id}/tracks/{trackId}":{"get":{"summary":"Track detail","description":"Requires the releases:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"trackId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"track":{"$ref":"#/components/schemas/Track"}},"required":["track"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__releases_id_tracks_trackId_","tags":["releases"]}},"/releases/{id}/edit-requests":{"get":{"summary":"Track edit requests","description":"Requires the releases:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"reject_reason":{"type":"string","nullable":true},"changes":{"type":"string"},"created_at":{"type":"string"}},"required":["id","status","reject_reason","changes","created_at"]}}},"required":["requests"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__releases_id_edit_requests","tags":["releases"]}},"/releases/{id}/delivery":{"get":{"summary":"Delivery state, destinations and activity","description":"Requires the releases:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"releaseId":{"type":"string"},"status":{"type":"string"},"stores":{"type":"array","items":{"type":"string"}},"platformLinks":{"nullable":true,"type":"object"},"activity":{"type":"array","items":{"type":"object"}}},"required":["releaseId","status","stores","platformLinks","activity"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__releases_id_delivery","tags":["releases"]}},"/files/{id}":{"get":{"summary":"Download an owned file","description":"Requires the uploads:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Authorized file download","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__files_id_","tags":["files"]}},"/streams/partner-summary":{"get":{"summary":"Partner-wide streams without paging through sub-accounts","description":"Requires the streams:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to reported history."},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to latest report."},{"name":"isrc","in":"query","schema":{"type":"string"},"description":""},{"name":"dsp","in":"query","schema":{"type":"string"},"description":""}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"latestPlayDate":{"type":"string","nullable":true},"fetchedAt":{"type":"string","nullable":true},"days":{"type":"integer"},"platformNames":{"type":"array","items":{"type":"string"}},"currentComplete":{"type":"boolean"},"previousComplete":{"type":"boolean"},"conflictRows":{"type":"integer"},"ambiguousIsrcs":{"type":"array","items":{"type":"string"}},"importedDays":{"type":"integer"},"streams":{"type":"number"},"previousStreams":{"type":"number"},"skips":{"type":"number","nullable":true},"skipRate":{"type":"number","nullable":true},"skipCoverage":{"type":"number","nullable":true},"changeRate":{"type":"number","nullable":true},"dailyAverage":{"type":"number"},"territoriesAvailable":{"type":"boolean"},"totalsScope":{"type":"string"},"dailyTotals":{"type":"array","items":{"$ref":"#/components/schemas/StreamDay"}},"dspTotals":{"type":"array","items":{"type":"object"}},"territories":{"$ref":"#/components/schemas/Territories"}},"required":["source","from","to","latestPlayDate","fetchedAt","days","platformNames","currentComplete","previousComplete","conflictRows","ambiguousIsrcs","importedDays","streams","previousStreams","skips","skipRate","skipCoverage","changeRate","dailyAverage","territoriesAvailable","totalsScope","dailyTotals","dspTotals","territories"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__streams_partner_summary","tags":["streams"]}},"/streams/summary":{"get":{"summary":"Stream summary, skips and data coverage","description":"Requires the streams:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to reported history."},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to latest report."},{"name":"isrc","in":"query","schema":{"type":"string"},"description":""},{"name":"dsp","in":"query","schema":{"type":"string"},"description":""}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StreamSummary"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__streams_summary","tags":["streams"]}},"/streams/daily":{"get":{"summary":"Streams by daily","description":"Requires the streams:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to reported history."},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to latest report."},{"name":"isrc","in":"query","schema":{"type":"string"},"description":""},{"name":"dsp","in":"query","schema":{"type":"string"},"description":""},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":""},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":""}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/StreamDay"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"from":{"type":"string","nullable":true},"to":{"type":"string","nullable":true},"fetchedAt":{"type":"string","nullable":true}},"required":["data","total","limit","offset","from","to","fetchedAt"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__streams_daily","tags":["streams"]}},"/streams/tracks":{"get":{"summary":"Streams by tracks","description":"Requires the streams:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to reported history."},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to latest report."},{"name":"isrc","in":"query","schema":{"type":"string"},"description":""},{"name":"dsp","in":"query","schema":{"type":"string"},"description":""},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":""},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":""}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/StreamTrack"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"from":{"type":"string","nullable":true},"to":{"type":"string","nullable":true},"fetchedAt":{"type":"string","nullable":true}},"required":["data","total","limit","offset","from","to","fetchedAt"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__streams_tracks","tags":["streams"]}},"/streams/releases":{"get":{"summary":"Streams by releases","description":"Requires the streams:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to reported history."},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to latest report."},{"name":"isrc","in":"query","schema":{"type":"string"},"description":""},{"name":"dsp","in":"query","schema":{"type":"string"},"description":""},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":""},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":""}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/StreamRelease"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"from":{"type":"string","nullable":true},"to":{"type":"string","nullable":true},"fetchedAt":{"type":"string","nullable":true}},"required":["data","total","limit","offset","from","to","fetchedAt"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__streams_releases","tags":["streams"]}},"/streams/platforms":{"get":{"summary":"Streams by platforms","description":"Requires the streams:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to reported history."},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to latest report."},{"name":"isrc","in":"query","schema":{"type":"string"},"description":""},{"name":"dsp","in":"query","schema":{"type":"string"},"description":""},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":""},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":""}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"dsp":{"type":"string"},"streams":{"type":"number"},"previousStreams":{"type":"number"},"skips":{"type":"number","nullable":true},"skipRate":{"type":"number","nullable":true},"skipCoverage":{"type":"number","nullable":true},"changeRate":{"type":"number","nullable":true},"dailyAverage":{"type":"number"}},"required":["dsp","streams","previousStreams","skips","skipRate","skipCoverage","changeRate","dailyAverage"]}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"from":{"type":"string","nullable":true},"to":{"type":"string","nullable":true},"fetchedAt":{"type":"string","nullable":true}},"required":["data","total","limit","offset","from","to","fetchedAt"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__streams_platforms","tags":["streams"]}},"/streams/territories":{"get":{"summary":"Streams by territories","description":"Requires the streams:read scope. Country snapshots retain their source period, which can differ from your selected daily range.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to reported history."},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to latest report."},{"name":"isrc","in":"query","schema":{"type":"string"},"description":""},{"name":"dsp","in":"query","schema":{"type":"string"},"description":""},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":""},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":""}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/StreamTerritory"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"from":{"type":"string","nullable":true},"to":{"type":"string","nullable":true},"fetchedAt":{"type":"string","nullable":true}},"required":["data","total","limit","offset","from","to","fetchedAt"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__streams_territories","tags":["streams"]}},"/streams/export":{"get":{"summary":"Export stream facts as CSV","description":"Requires the streams:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to reported history."},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive UTC play date; defaults to latest report."},{"name":"isrc","in":"query","schema":{"type":"string"},"description":""},{"name":"dsp","in":"query","schema":{"type":"string"},"description":""}],"responses":{"200":{"description":"UTF-8 CSV","content":{"text/csv":{"schema":{"type":"string"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__streams_export","tags":["streams"]}},"/earnings/report":{"get":{"summary":"Revenue by period, release, track, artist, platform or country","description":"Requires the earnings:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":""},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":""},{"name":"from","in":"query","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"description":""},{"name":"to","in":"query","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"description":""},{"name":"groupBy","in":"query","schema":{"type":"string","enum":["period","release","track","artist","platform","territory","isrc"]},"description":""},{"name":"format","in":"query","schema":{"type":"string","enum":["json","csv"]},"description":""},{"name":"isrc","in":"query","schema":{"type":"string"},"description":"Filter earnings to one normalized ISRC."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"dimension":{"type":"string","nullable":true},"currency":{"type":"string","nullable":true},"units":{"type":"number"},"amountMicros":{"type":"number"}},"required":["dimension","currency","units","amountMicros"]}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"amountUnit":{"type":"string"},"available":{"type":"boolean"}},"required":["data","total","available"]}},"text/csv":{"schema":{"type":"string"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__earnings_report","tags":["earnings"]}},"/earnings/entries":{"get":{"summary":"Statement rows by ISRC, DSP, country and sales window","description":"Raw statement receipts before WBBT commission and splits. Preserves micro precision. Use /earnings for actual credited EUR amounts and /balance for withdrawable balance. Only rows owned by this sub-account are returned.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":""},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":""},{"name":"from","in":"query","schema":{"type":"string"},"description":"YYYY-MM"},{"name":"to","in":"query","schema":{"type":"string"},"description":"YYYY-MM"},{"name":"isrc","in":"query","schema":{"type":"string"},"description":"Normalized recording code"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"revenue_entry_id":{"type":"string","nullable":true},"track_id":{"type":"string","nullable":true},"release_id":{"type":"string","nullable":true},"track_title":{"type":"string"},"isrc":{"type":"string"},"channel":{"type":"string","nullable":true},"country_code":{"type":"string","nullable":true},"units":{"type":"number"},"amountMicros":{"type":"integer"},"revenue":{"type":"number"},"currency":{"type":"string"},"period":{"type":"string"},"sales_start_date":{"type":"string","nullable":true},"sales_end_date":{"type":"string","nullable":true},"report_date":{"type":"string","nullable":true},"amountBasis":{"type":"string"}},"required":["track_title","isrc","units","amountMicros","revenue","currency","period","amountBasis"]}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"available":{"type":"boolean"},"amountBasis":{"type":"string"}},"required":["data","total","available"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__earnings_entries","tags":["earnings"]}},"/webhook-endpoints/{id}/rotate-secret":{"post":{"summary":"Rotate the endpoint signing secret","description":"Requires the webhooks:write scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"secret":{"type":"string"}},"required":["id","secret"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"post__webhook_endpoints_id_rotate_secret","tags":["webhook-endpoints"]}},"/webhook-endpoints/{id}/deliveries":{"get":{"summary":"Inspect webhook attempts and retry times","description":"Requires the webhooks:write scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":""},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":""},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"deliveries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"event_type":{"type":"string"},"status":{"type":"string"},"attempts":{"type":"integer"},"response_status":{"type":"integer","nullable":true},"last_error":{"type":"string","nullable":true},"next_attempt_at":{"type":"string","nullable":true},"delivered_at":{"type":"string","nullable":true}},"required":["id","event_type","status","attempts","response_status","last_error","next_attempt_at","delivered_at"]}},"limit":{"type":"integer"},"offset":{"type":"integer"}},"required":["deliveries","limit","offset"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__webhook_endpoints_id_deliveries","tags":["webhook-endpoints"]}},"/webhook-endpoints/{id}/deliveries/{deliveryId}/retry":{"post":{"summary":"Retry an undelivered event","description":"Requires the webhooks:write scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"202":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"}},"required":["id","status"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"post__webhook_endpoints_id_deliveries_deliveryId_retry","tags":["webhook-endpoints"]}},"/balance":{"get":{"summary":"Available balance and pending requests (EUR; live only)","description":"Requires the earnings:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string"},"available":{"type":"number"},"pending":{"type":"number"}},"required":["currency","available","pending"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__balance","tags":["balance"]}},"/payment-methods":{"get":{"summary":"Saved payout destinations (payouts feature; live only)","description":"Requires the payment-methods:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"paymentMethods":{"type":"array","items":{"$ref":"#/components/schemas/PaymentMethod"}}},"required":["paymentMethods"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__payment_methods","tags":["payment-methods"]},"post":{"summary":"Save a payout destination (payouts feature; live only)","description":"Requires payment-methods:write and payouts enabled. IBAN requires checksum-valid iban and accountHolder; other types require their corresponding email field. Idempotency-Key is mandatory. Test keys cannot store real payout details.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["IBAN","PAYPAL","WISE","PAYONEER"]},"bankName":{"type":"string"},"accountHolder":{"type":"string"},"iban":{"type":"string"},"swiftBic":{"type":"string"},"paypalEmail":{"type":"string"},"wiseEmail":{"type":"string"},"payoneerEmail":{"type":"string"},"isDefault":{"type":"boolean"}},"required":["type"]}}}},"operationId":"post__payment_methods","tags":["payment-methods"]}},"/payment-methods/{id}":{"delete":{"summary":"Remove an owned destination; existing withdrawal snapshots are retained","description":"Requires the payment-methods:write scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Success"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"delete__payment_methods_id_","tags":["payment-methods"]}},"/withdrawals":{"get":{"summary":"Withdrawal history and processing status (live only)","description":"Requires the withdrawals:read scope.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"withdrawals":{"type":"array","items":{"$ref":"#/components/schemas/Withdrawal"}}},"required":["withdrawals"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__withdrawals","tags":["withdrawals"]},"post":{"summary":"Request manual WBBT payout; reserves balance atomically","description":"Live only; requires payouts feature. Positive EUR amount, at most two decimals. Saves an immutable destination snapshot and deducts available balance once. PENDING becomes APPROVED or REJECTED through WBBT administration. Rejection returns reserved balance once. No automatic bank transfer. Idempotency-Key prevents duplicate requests.","security":[{"ApiKeyAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SubaccountHeader"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","maxLength":200},"description":"Required for writes. Replays the first response for the same partner, mode, scopes and payload for 24 hours. Different payload: 409."}],"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"amount":{"type":"number"},"currency":{"type":"string"}},"required":["id","status","amount","currency"]}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"400":{"description":"Invalid request or query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"401":{"description":"Missing, invalid, revoked or expired credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"402":{"description":"Agreement inactive or read-only","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"403":{"description":"Scope, ownership or feature restriction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"404":{"description":"Resource not found within this partner and mode","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"409":{"description":"State conflict or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"422":{"description":"Submission validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"429":{"description":"Shared partner quota exhausted; observe Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}},"500":{"description":"Transient server failure; retry with the same idempotency key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":true,"minimum":0,"multipleOf":0.01},"paymentMethodId":{"type":"string"}},"required":["amount","paymentMethodId"]}}}},"operationId":"post__withdrawals","tags":["withdrawals"]}},"/openapi.json":{"get":{"summary":"Download the public OpenAPI contract","description":"Requires the  scope.","security":[],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Support correlation ID"}}}},"operationId":"get__openapi_json","tags":["openapi.json"]}}}}