Skip to main content
GET
/
v1
/
suno
/
fetch
/
{task_id}
official-format (query task)
curl --request GET \
  --url https://api.example.com/v1/suno/fetch/{task_id}
Suno’s query task.mdx for the query task API.
curl --location 'https://gptproto.com/v1/suno/fetch/15410652-357c-47fa-8ad9-a4a145fbfa14' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json'
{
  "code": "error",
  "data": null,
  "message": "Task not found"
}

Path Parameters

Task Status Values

StatusDescriptionNext Action
queuedTask is waiting in queue to be processedContinue polling
processingTask is currently being processedContinue polling, check progress
completedTask completed successfully, audio is readyDownload audio from audio_url
failedTask failedCheck error_message, retry if needed