Poll music status

Error

A valid request URL is required to generate request examples

{
  "success": true,
  "data": {
    "id": "<string>",
    "status": "<string>",
    "outputUrl": "<string>",
    "error": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "completedAt": "2023-11-07T05:31:56Z"
  }
}

{
  "error": "<string>",
  "success": true,
  "code": "<string>",
  "message": "<string>"
}

GET

music

status

{id}

Error

A valid request URL is required to generate request examples

{
  "success": true,
  "data": {
    "id": "<string>",
    "status": "<string>",
    "outputUrl": "<string>",
    "error": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "completedAt": "2023-11-07T05:31:56Z"
  }
}

{
  "error": "<string>",
  "success": true,
  "code": "<string>",
  "message": "<string>"
}

Poll music generation jobs created via Create song. Use the id returned from the create response. Poll every few seconds until status is COMPLETED or FAILED.

curl "https://mvp.tryunsora.com/api/v1/music/status/GENERATION_ID" \
  -H "Authorization: Bearer uns_live_YOUR_API_KEY"

Example response:

{
  "success": true,
  "data": {
    "id": "cm123...",
    "status": "COMPLETED",
    "outputUrl": "https://files.tryunsora.com/....mp3",
    "error": null,
    "createdAt": "2026-06-10T12:00:00.000Z",
    "updatedAt": "2026-06-10T12:02:30.000Z",
    "completedAt": "2026-06-10T12:02:30.000Z"
  }
}

When status is COMPLETED, download the audio from outputUrl.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

Response

Status

success

boolean

required

data

object

required

Show child attributes

API documentation

CLI

User

Accounts

Posts

Generation status

Video generator

Image generator

Music generator

Voiceover

AI influencer

Thumbnail generator

Clipping

Uploads

Poll music status

Authorizations

Path Parameters

Response