Poll voiceover status

Error

A valid request URL is required to generate request examples

{
  "success": true,
  "data": {
    "id": "<string>",
    "status": "<string>",
    "voiceId": "<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

voiceovers

status

{id}

Error

A valid request URL is required to generate request examples

{
  "success": true,
  "data": {
    "id": "<string>",
    "status": "<string>",
    "voiceId": "<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 voiceover jobs created via Create voiceover. Use the id returned from the create response. Poll every few seconds until status is COMPLETED or FAILED. Jobs typically finish in ~20 seconds.

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

Example response:

{
  "success": true,
  "data": {
    "id": "cm123...",
    "status": "COMPLETED",
    "voiceId": "George",
    "outputUrl": "https://files.tryunsora.com/....mp3",
    "error": null,
    "createdAt": "2026-07-17T12:00:00.000Z",
    "updatedAt": "2026-07-17T12:00:22.000Z",
    "completedAt": "2026-07-17T12:00:22.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 voiceover status

Authorizations

Path Parameters

Response