Get Project Video Status

Track pipeline status of a video, per target language

GET /api/v1/projects/{projectId}/videos/{videoId}/status

cURL

curl -X GET \
  https://studio.dubformer.ai/api/v1/projects/proj_5f83a14b2ec1b/videos/vid_7a92c36d4fe3c/status \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response

{
  "langs": [
    {
      "lang": "es-ES",
      "phase": "voiceover",
      "pendingOn": "editor",
      "isError": false,
      "eta": null
    },
    {
      "lang": "fr-FR",
      "phase": "translation",
      "pendingOn": "system",
      "isError": false,
      "eta": "2026-07-17T12:20:00.000Z"
    }
  ]
}

This endpoint reports the processing status of a video, broken down per target language. For each language you get the current stage, whether it is being processed automatically or worked on manually, whether anything failed, and a rough completion estimate.

Each video produces one entry per target language. All target languages are present from the start. Transcription-only videos return a single entry keyed by the source language.

Path Parameters

projectId · string · required

The unique identifier of the project.

videoId · string · required

The unique identifier of the video.

Response

langs · object[]

One entry per target language.

Hide language

lang · string

Language of this entry (source language for transcription-type videos).

phase · string

How far the pipeline has progressed. One of: transcription (transcribing the source audio), translation (translating into the target language), voiceover (generating and refining the synthesized voice), mixing (mixing the voice with the original background audio), rendering (producing the final video file).

pendingOn · string | null

Whose side the ball is on right now. system — automated processing is running or queued. editor — our team is working on it manually, or the stage is ready and awaiting further manual input. null — this language is stuck on an error (see isError).

isError · boolean

true if the latest processing step failed. Clears automatically once a retry starts.

eta · string | null

Approximate ISO-8601 completion time of the step currently running. null while a step is queued or while a manual step is in progress.

eta is an approximate estimate for the current running step only — not the whole remaining pipeline. There is no terminal “done” state: once finished, an entry rests at pendingOn: "editor" (edits are always possible). Use the export endpoints to fetch produced files.

A Voice lines (tts) video has no transcription, translation or mixing. It reports voiceover while the script is uploaded and its voices are selected, then rendering while the lines are synthesized. A finished render rests at pendingOn: "editor"; a render that failed for some or all lines sets isError.

cURL

curl -X GET \
  https://studio.dubformer.ai/api/v1/projects/proj_5f83a14b2ec1b/videos/vid_7a92c36d4fe3c/status \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response

{
  "langs": [
    {
      "lang": "es-ES",
      "phase": "voiceover",
      "pendingOn": "editor",
      "isError": false,
      "eta": null
    },
    {
      "lang": "fr-FR",
      "phase": "translation",
      "pendingOn": "system",
      "isError": false,
      "eta": "2026-07-17T12:20:00.000Z"
    }
  ]
}

Error Response

{
  "error": "Video not found"
}