Suno Task API

Fetch Task Status

Poll the status of any Suno async job (music generation, stems, cover, etc.).

Status Flow

NOT_START -> SUBMITTED -> QUEUED -> IN_PROGRESS -> SUCCESS / FAILURE

Polling

  • Single task: GET /suno/fetch/{id}
  • Batch task lookup: POST /suno/fetch with {"ids":["task_xxx"]}
  • Recommended interval: 10-15 seconds
  • Returned records are scoped to the current authenticated user or token owner
  • Failed tasks are auto-refunded

Result Shape

  • data is the persisted CCAPI task record
  • data.status is the task state
  • data.progress is a string like 20% or 100%
  • data.data is the normalized operation result payload
  • Music-style actions typically return data.data.clips[]

CCAPI keeps the response shape stable and does not expose upstream provider internals.

get/suno/fetch/{id}

Request

  • Base URL: https://api.ccapi.ai
  • URL: https://api.ccapi.ai/suno/fetch/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The public CCAPI task ID returned by a submit endpoint, e.g. task_xxx.

Response

Task status

codestring required
messagestring

Example response

{
  "code": "success"
}

Changes

No recorded changes to this operation across all 1 revision of this API.