Inspect Suno storage policy, rate and subscription

GET/api/v1/suno/storageCopy URL

Authentication · x-api-key

Read availability, the current published storage rate, active subscription, billable bytes and unpaid usage. Check available before offering paid storage enrollment. All amounts are integer credit units represented as strings.

All endpointsRequestResponsesCode

Request

No request parameters.

Responses

200 OK

application/json

• Response 200 · audioFreeDaysRequired

  number

• Response 200 · availableRequired

  boolean

• Response 200 · billableBytesRequired

  string

• Response 200 · billingUnitRequired

  string

• Response 200 · cancellationGraceDaysRequired

  number

• Response 200 · fixedRetentionDaysRequired

  number

• Response 200 · publishedRateUnitsPerGbMonthRequired

  string

• Response 200 · subscriptionRequired

  null | object

  Must match at least one alternative.

  2 fields / alternatives

  • Response 200 · subscription · anyOf 1Alternative

    null

  • Response 200 · subscription · anyOf 2Alternative

    object
    5 fields

    • Response 200 · subscription · anyOf 2.graceUntilRequired

      string | null

      Must match at least one alternative.

      2 fields / alternatives

      • Response 200 · subscription · anyOf 2.graceUntil · anyOf 1Alternative

        string

        Format: date-time.

      • Response 200 · subscription · anyOf 2.graceUntil · anyOf 2Alternative

        null

    • Response 200 · subscription · anyOf 2.meteredThroughRequired

      string

      Format: date-time.

    • Response 200 · subscription · anyOf 2.rateUnitsPerGbMonthRequired

      string

    • Response 200 · subscription · anyOf 2.statusRequired

      string

    • Response 200 · subscription · anyOf 2.stoppedAtRequired

      string | null

      Must match at least one alternative.

      2 fields / alternatives

      • Response 200 · subscription · anyOf 2.stoppedAt · anyOf 1Alternative

        string

        Format: date-time.

      • Response 200 · subscription · anyOf 2.stoppedAt · anyOf 2Alternative

        null

• Response 200 · unpaidUnitsRequired

  string

401 Unauthorized

application/json

• Response 401 · errorRequired

  object
  3 fields

  • Response 401 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 401 · error.messageRequired

    string

    Human readable error message

  • Response 401 · error.detailsOptional

    object

    Additional error details (optional)

• Response 401 · successRequired

  false

  Always false for error responses

403 Forbidden

application/json

• Response 403 · errorRequired

  object
  3 fields

  • Response 403 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 403 · error.messageRequired

    string

    Human readable error message

  • Response 403 · error.detailsOptional

    object

    Additional error details (optional)

• Response 403 · successRequired

  false

  Always false for error responses

429 Too Many Requests

Request allowance or task admission capacity exceeded. Follow Retry-After when present; otherwise wait for active tasks and use bounded backoff. Limits do not guarantee throughput. For SSE, this is the HTTP connection response, not an event.

application/json

• Response 429 · errorRequired

  object
  3 fields

  • Response 429 · error.codeRequired

    string

    RATE_LIMITED for request and task admission rejections.

  • Response 429 · error.messageRequired

    string

  • Response 429 · error.detailsOptional

    object

    Optional and scope-dependent. Request limits supply scope/policy/type/limit/current/retryAfterSec. Task admission supplies inFlight/limit/tier, plus scope=apiKey for a key cap. IP rejection can omit details. In-flight rejection does not promise Retry-After.

    8 fields

    • Response 429 · error.details.currentOptional

      integer

      Minimum: 0.

    • Response 429 · error.details.inFlightOptional

      integer

      Minimum: 0.

    • Response 429 · error.details.limitOptional

      integer

      Minimum: 0.

    • Response 429 · error.details.policyOptional

      "operation" | "query"

    • Response 429 · error.details.retryAfterSecOptional

      integer

      Minimum: 1.

    • Response 429 · error.details.scopeOptional

      "user" | "api-key" | "ip" | "apiKey"

    • Response 429 · error.details.tierOptional

      "FREE" | "PREMIUM" | "ENTERPRISE"

    • Response 429 · error.details.typeOptional

      "rps" | "daily" | "monthly"

• Response 429 · successRequired

  false

  Default: false.

500 Internal Server Error

application/json

• Response 500 · errorRequired

  object
  3 fields

  • Response 500 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 500 · error.messageRequired

    string

    Human readable error message

  • Response 500 · error.detailsOptional

    object

    Additional error details (optional)

• Response 500 · successRequired

  false

  Always false for error responses

Request example

Wrap lines

cURL

curl --globoff --request GET \
  --url 'https://api.omnapi.com/api/v1/suno/storage' \
  --header "x-api-key: $OMNAPI_KEY"

Node.js

const response = await fetch("https://api.omnapi.com/api/v1/suno/storage", {
  method: "GET",
  headers: {
    "x-api-key": process.env.OMNAPI_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.text());

Python

import os
import requests

response = requests.request(
    "GET", "https://api.omnapi.com/api/v1/suno/storage",
    headers={
        "x-api-key": os.environ["OMNAPI_KEY"],
    },
    timeout=60,
)
response.raise_for_status()
print(response.text)

Set URL and header variables.

Interactive API Explorer → · OpenAPI JSON