Skip to main content
GET
/
suno
/
v2
/
fetch
cURL
curl --request GET \
  --url https://api.ttapi.io/suno/v2/fetch \
  --header 'TT-API-KEY: <api-key>'
{
  "status": "SUCCESS",
  "message": "success",
  "jobId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "data": {
    "jobId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "action": "music",
    "progress": "100%",
    "mv": "chirp-v5",
    "quota": "6",
    "hookUrl": "https://webhook-test.com/ed9731f4026f04e7c0cfa99e41d2b2fc",
    "musics": [
      {
        "musicId": "xxxxxxxxxxxxxxxxx",
        "prompt": "xxxxxxxxxxxxxxxxxx",
        "title": "xxxxx",
        "tags": "xxxxx",
        "imageUrl": "https://cdn2.suno.ai/xxxxxxxxxxxxxxxxx.jpeg",
        "imageLargeUrl": "https://cdn2.suno.ai/xxxxxxxxxxxxxx.jpeg",
        "audioUrl": "https://cdn1.suno.ai/xxxxxxxxxxxxxxx.mp3",
        "videoUrl": "https://cdn1.suno.ai/xxxxxxxxxxxxxxx.mp4",
        "duration": "211.44",
        "negativeTags": "xxxxxxxxxxxxxxxxxxx",
        "styleWeight": null,
        "weirdnessConstraint": null,
        "audioWeight": null,
        "createdAt": "2026-03-03T02:23:51.401Z"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ttapi.io/llms.txt

Use this file to discover all available pages before exploring further.

Use the Suno Fetch API to retrieve the latest status and final output for asynchronous Suno jobs on TTAPI.

Authorizations

​
TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Query Parameters

​
jobId
string
required

Job ID returned by the generation request

Response

Request successful

​
status
enum<string>
required
Available options:
ON_QUEUE,
SUCCESS,
FAILED
​
message
string
required

Response message

​
jobId
string

Task ID

​
data
object

Audio task result

Last modified on April 17, 2026