---
title: "Get dubbing project status and videos"
method: GET
path: "/v2/dubbing/{dubbing_project_id}"
tags: ["Dubbing"]
---

# Get dubbing project status and videos

`GET /v2/dubbing/{dubbing_project_id}`

Retrieve the status of a dubbing project and its dubbed videos.
**Status values:** - `uploading`: The source video is still being uploaded/processed (only for projects created via sourceVideoUrl) - `in_progress`: Dubbing is in progress - `complete`: All dubbing is complete - `error`: An error occurred during dubbing
**Response varies by status:** - UPLOADING: Returns only id and status - IN_PROGRESS/COMPLETE: Returns id, status, and dubbedAssets array - ERROR: Returns id, status, and errorCode
**Dubbed asset status:** - IN_PROGRESS: Returns minimal data (id, language, status) - COMPLETE: Returns full data including download URLs - ERROR: Returns minimal data plus errorCode

## Path parameters

- `dubbing_project_id` string, uuid, required

## Query parameters

- `targetLanguages` string[]

## Response `200`

Successfully retrieved dubbing project status

- union
  - GetDubbingProjectVideosResponseUploading — Response when dubbing project is still uploading from sourceVideoUrl.
    - `id` string, uuid, required
    - `status` 'uploading' — The status of the dubbed video.
  - GetDubbingProjectVideosResponseInProgress — Response when dubbing project is in progress.
    - `id` string, uuid, required
    - `status` 'in_progress' — The status of the dubbed video.
    - `dubbedAssets` union[] — The dubbed videos in the project.
      - union
        - DubbedAssetInProgress — Dubbed asset in progress - minimal data.
          - `id` string, uuid, required
          - `language` 'af' | 'sq' | 'am' | 'ar' | 'ar-DZ' | 'ar-BH' | 'ar-EG' | 'ar-IQ' | 'ar-JO' | 'ar-KW' | 'ar-LY' | 'ar-MA' | 'ar-QA' | 'ar-SA' | 'ar-SY' | 'ar-TN' | 'ar-AE' | 'ar-YE' | 'hy' | 'as' | 'az' | 'eu' | 'bn' | 'bs' | 'bg' | 'ca' | 'zh' | 'zh-CN' | 'zh-HK' | 'zh-TW' | 'hr' | 'cs' | 'da' | 'nl' | 'nl-BE' | 'nl-NL' | 'en' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-HK' | 'en-IN' | 'en-IE' | 'en-KE' | 'en-MX' | 'en-NZ' | 'en-NG' | 'en-PH' | 'en-SG' | 'en-ZA' | 'en-TZ' | 'en-US' | 'et' | 'fil' | 'fi' | 'fr' | 'fr-BE' | 'fr-CA' | 'fr-FR' | 'fr-CH' | 'gl' | 'ka' | 'de' | 'de-AT' | 'de-DE' | 'de-CH' | 'el' | 'gu' | 'he' | 'hi' | 'hu' | 'is' | 'id' | 'ga' | 'it' | 'ja' | 'jw' | 'kn' | 'kk' | 'km' | 'ko' | 'lo' | 'lv' | 'lt' | 'mk' | 'ms' | 'ml' | 'mt' | 'mr' | 'mn' | 'ne' | 'no' | 'nb' | 'nn' | 'or' | 'pa' | 'ps' | 'fa' | 'pl' | 'pt' | 'pt-BR' | 'pt-PT' | 'ro' | 'ru' | 'sr' | 'si' | 'sk' | 'sl' | 'so' | 'es' | 'es-AR' | 'es-BO' | 'es-CL' | 'es-CO' | 'es-CR' | 'es-CU' | 'es-DO' | 'es-EC' | 'es-SV' | 'es-GQ' | 'es-GT' | 'es-HN' | 'es-LA' | 'es-MX' | 'es-NI' | 'es-PA' | 'es-PY' | 'es-PE' | 'es-PR' | 'es-ES' | 'es-US' | 'es-UY' | 'es-VE' | 'su' | 'sw' | 'sv' | 'ta' | 'ta-IN' | 'ta-SG' | 'ta-LK' | 'te' | 'th' | 'tr' | 'uk' | 'ur' | 'uz' | 'vi' | 'cy' | 'zu', required
          - `status` 'in_progress' — The status of the dubbed video.
        - DubbedAssetComplete — Dubbed asset complete - full data.
          - `id` string, uuid, required
          - `title` string, required — Title of the video (used on the video's share page).
          - `description` string, required — Description of the video (used on the video's share page).
          - `language` 'af' | 'sq' | 'am' | 'ar' | 'ar-DZ' | 'ar-BH' | 'ar-EG' | 'ar-IQ' | 'ar-JO' | 'ar-KW' | 'ar-LY' | 'ar-MA' | 'ar-QA' | 'ar-SA' | 'ar-SY' | 'ar-TN' | 'ar-AE' | 'ar-YE' | 'hy' | 'as' | 'az' | 'eu' | 'bn' | 'bs' | 'bg' | 'ca' | 'zh' | 'zh-CN' | 'zh-HK' | 'zh-TW' | 'hr' | 'cs' | 'da' | 'nl' | 'nl-BE' | 'nl-NL' | 'en' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-HK' | 'en-IN' | 'en-IE' | 'en-KE' | 'en-MX' | 'en-NZ' | 'en-NG' | 'en-PH' | 'en-SG' | 'en-ZA' | 'en-TZ' | 'en-US' | 'et' | 'fil' | 'fi' | 'fr' | 'fr-BE' | 'fr-CA' | 'fr-FR' | 'fr-CH' | 'gl' | 'ka' | 'de' | 'de-AT' | 'de-DE' | 'de-CH' | 'el' | 'gu' | 'he' | 'hi' | 'hu' | 'is' | 'id' | 'ga' | 'it' | 'ja' | 'jw' | 'kn' | 'kk' | 'km' | 'ko' | 'lo' | 'lv' | 'lt' | 'mk' | 'ms' | 'ml' | 'mt' | 'mr' | 'mn' | 'ne' | 'no' | 'nb' | 'nn' | 'or' | 'pa' | 'ps' | 'fa' | 'pl' | 'pt' | 'pt-BR' | 'pt-PT' | 'ro' | 'ru' | 'sr' | 'si' | 'sk' | 'sl' | 'so' | 'es' | 'es-AR' | 'es-BO' | 'es-CL' | 'es-CO' | 'es-CR' | 'es-CU' | 'es-DO' | 'es-EC' | 'es-SV' | 'es-GQ' | 'es-GT' | 'es-HN' | 'es-LA' | 'es-MX' | 'es-NI' | 'es-PA' | 'es-PY' | 'es-PE' | 'es-PR' | 'es-ES' | 'es-US' | 'es-UY' | 'es-VE' | 'su' | 'sw' | 'sv' | 'ta' | 'ta-IN' | 'ta-SG' | 'ta-LK' | 'te' | 'th' | 'tr' | 'uk' | 'ur' | 'uz' | 'vi' | 'cy' | 'zu', required
          - `status` 'complete' — The status of the dubbed video.
          - `createdAt` integer, nullable — UNIX timestamp representing the time video was created.
          - `lastUpdatedAt` integer, nullable — UNIX timestamp representing the time video was last updated.
          - `visibility` 'public' | 'private', required — Describes the visibility settings of the video.
          - `download` string, required — A time-limited URL which may be used to download the video.
          - `thumbnail` DubbedAssetThumbnail, required
            - `image` string, nullable — A time-limited URL which may be used to download the video thumbnail.
            - `gif` string, nullable — A time-limited URL which may be used to download the video animated GIF thumbnail.
          - `captions` DubbedAssetCaptions, required
            - `srt` string, nullable — A time-limited URL which may be used to download the video captions in srt format.
            - `vtt` string, nullable — A time-limited URL which may be used to download the video captions in vtt format.
        - DubbedAssetError — Dubbed asset error - minimal data + error code.
          - `id` string, uuid, required
          - `language` 'af' | 'sq' | 'am' | 'ar' | 'ar-DZ' | 'ar-BH' | 'ar-EG' | 'ar-IQ' | 'ar-JO' | 'ar-KW' | 'ar-LY' | 'ar-MA' | 'ar-QA' | 'ar-SA' | 'ar-SY' | 'ar-TN' | 'ar-AE' | 'ar-YE' | 'hy' | 'as' | 'az' | 'eu' | 'bn' | 'bs' | 'bg' | 'ca' | 'zh' | 'zh-CN' | 'zh-HK' | 'zh-TW' | 'hr' | 'cs' | 'da' | 'nl' | 'nl-BE' | 'nl-NL' | 'en' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-HK' | 'en-IN' | 'en-IE' | 'en-KE' | 'en-MX' | 'en-NZ' | 'en-NG' | 'en-PH' | 'en-SG' | 'en-ZA' | 'en-TZ' | 'en-US' | 'et' | 'fil' | 'fi' | 'fr' | 'fr-BE' | 'fr-CA' | 'fr-FR' | 'fr-CH' | 'gl' | 'ka' | 'de' | 'de-AT' | 'de-DE' | 'de-CH' | 'el' | 'gu' | 'he' | 'hi' | 'hu' | 'is' | 'id' | 'ga' | 'it' | 'ja' | 'jw' | 'kn' | 'kk' | 'km' | 'ko' | 'lo' | 'lv' | 'lt' | 'mk' | 'ms' | 'ml' | 'mt' | 'mr' | 'mn' | 'ne' | 'no' | 'nb' | 'nn' | 'or' | 'pa' | 'ps' | 'fa' | 'pl' | 'pt' | 'pt-BR' | 'pt-PT' | 'ro' | 'ru' | 'sr' | 'si' | 'sk' | 'sl' | 'so' | 'es' | 'es-AR' | 'es-BO' | 'es-CL' | 'es-CO' | 'es-CR' | 'es-CU' | 'es-DO' | 'es-EC' | 'es-SV' | 'es-GQ' | 'es-GT' | 'es-HN' | 'es-LA' | 'es-MX' | 'es-NI' | 'es-PA' | 'es-PY' | 'es-PE' | 'es-PR' | 'es-ES' | 'es-US' | 'es-UY' | 'es-VE' | 'su' | 'sw' | 'sv' | 'ta' | 'ta-IN' | 'ta-SG' | 'ta-LK' | 'te' | 'th' | 'tr' | 'uk' | 'ur' | 'uz' | 'vi' | 'cy' | 'zu', required
          - `status` 'error' — The status of the dubbed video.
          - `errorCode` 'moderation' | 'video_duration_limit_reached' | 'invalid_target_language' | 'processing_error', required
  - GetDubbingProjectVideosResponseComplete — Response when dubbing project is complete.
    - `id` string, uuid, required
    - `status` 'complete' — The status of the dubbed video.
    - `dubbedAssets` union[] — The dubbed videos in the project.
      - union
        - DubbedAssetInProgress — Dubbed asset in progress - minimal data.
          - `id` string, uuid, required
          - `language` 'af' | 'sq' | 'am' | 'ar' | 'ar-DZ' | 'ar-BH' | 'ar-EG' | 'ar-IQ' | 'ar-JO' | 'ar-KW' | 'ar-LY' | 'ar-MA' | 'ar-QA' | 'ar-SA' | 'ar-SY' | 'ar-TN' | 'ar-AE' | 'ar-YE' | 'hy' | 'as' | 'az' | 'eu' | 'bn' | 'bs' | 'bg' | 'ca' | 'zh' | 'zh-CN' | 'zh-HK' | 'zh-TW' | 'hr' | 'cs' | 'da' | 'nl' | 'nl-BE' | 'nl-NL' | 'en' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-HK' | 'en-IN' | 'en-IE' | 'en-KE' | 'en-MX' | 'en-NZ' | 'en-NG' | 'en-PH' | 'en-SG' | 'en-ZA' | 'en-TZ' | 'en-US' | 'et' | 'fil' | 'fi' | 'fr' | 'fr-BE' | 'fr-CA' | 'fr-FR' | 'fr-CH' | 'gl' | 'ka' | 'de' | 'de-AT' | 'de-DE' | 'de-CH' | 'el' | 'gu' | 'he' | 'hi' | 'hu' | 'is' | 'id' | 'ga' | 'it' | 'ja' | 'jw' | 'kn' | 'kk' | 'km' | 'ko' | 'lo' | 'lv' | 'lt' | 'mk' | 'ms' | 'ml' | 'mt' | 'mr' | 'mn' | 'ne' | 'no' | 'nb' | 'nn' | 'or' | 'pa' | 'ps' | 'fa' | 'pl' | 'pt' | 'pt-BR' | 'pt-PT' | 'ro' | 'ru' | 'sr' | 'si' | 'sk' | 'sl' | 'so' | 'es' | 'es-AR' | 'es-BO' | 'es-CL' | 'es-CO' | 'es-CR' | 'es-CU' | 'es-DO' | 'es-EC' | 'es-SV' | 'es-GQ' | 'es-GT' | 'es-HN' | 'es-LA' | 'es-MX' | 'es-NI' | 'es-PA' | 'es-PY' | 'es-PE' | 'es-PR' | 'es-ES' | 'es-US' | 'es-UY' | 'es-VE' | 'su' | 'sw' | 'sv' | 'ta' | 'ta-IN' | 'ta-SG' | 'ta-LK' | 'te' | 'th' | 'tr' | 'uk' | 'ur' | 'uz' | 'vi' | 'cy' | 'zu', required
          - `status` 'in_progress' — The status of the dubbed video.
        - DubbedAssetComplete — Dubbed asset complete - full data.
          - `id` string, uuid, required
          - `title` string, required — Title of the video (used on the video's share page).
          - `description` string, required — Description of the video (used on the video's share page).
          - `language` 'af' | 'sq' | 'am' | 'ar' | 'ar-DZ' | 'ar-BH' | 'ar-EG' | 'ar-IQ' | 'ar-JO' | 'ar-KW' | 'ar-LY' | 'ar-MA' | 'ar-QA' | 'ar-SA' | 'ar-SY' | 'ar-TN' | 'ar-AE' | 'ar-YE' | 'hy' | 'as' | 'az' | 'eu' | 'bn' | 'bs' | 'bg' | 'ca' | 'zh' | 'zh-CN' | 'zh-HK' | 'zh-TW' | 'hr' | 'cs' | 'da' | 'nl' | 'nl-BE' | 'nl-NL' | 'en' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-HK' | 'en-IN' | 'en-IE' | 'en-KE' | 'en-MX' | 'en-NZ' | 'en-NG' | 'en-PH' | 'en-SG' | 'en-ZA' | 'en-TZ' | 'en-US' | 'et' | 'fil' | 'fi' | 'fr' | 'fr-BE' | 'fr-CA' | 'fr-FR' | 'fr-CH' | 'gl' | 'ka' | 'de' | 'de-AT' | 'de-DE' | 'de-CH' | 'el' | 'gu' | 'he' | 'hi' | 'hu' | 'is' | 'id' | 'ga' | 'it' | 'ja' | 'jw' | 'kn' | 'kk' | 'km' | 'ko' | 'lo' | 'lv' | 'lt' | 'mk' | 'ms' | 'ml' | 'mt' | 'mr' | 'mn' | 'ne' | 'no' | 'nb' | 'nn' | 'or' | 'pa' | 'ps' | 'fa' | 'pl' | 'pt' | 'pt-BR' | 'pt-PT' | 'ro' | 'ru' | 'sr' | 'si' | 'sk' | 'sl' | 'so' | 'es' | 'es-AR' | 'es-BO' | 'es-CL' | 'es-CO' | 'es-CR' | 'es-CU' | 'es-DO' | 'es-EC' | 'es-SV' | 'es-GQ' | 'es-GT' | 'es-HN' | 'es-LA' | 'es-MX' | 'es-NI' | 'es-PA' | 'es-PY' | 'es-PE' | 'es-PR' | 'es-ES' | 'es-US' | 'es-UY' | 'es-VE' | 'su' | 'sw' | 'sv' | 'ta' | 'ta-IN' | 'ta-SG' | 'ta-LK' | 'te' | 'th' | 'tr' | 'uk' | 'ur' | 'uz' | 'vi' | 'cy' | 'zu', required
          - `status` 'complete' — The status of the dubbed video.
          - `createdAt` integer, nullable — UNIX timestamp representing the time video was created.
          - `lastUpdatedAt` integer, nullable — UNIX timestamp representing the time video was last updated.
          - `visibility` 'public' | 'private', required — Describes the visibility settings of the video.
          - `download` string, required — A time-limited URL which may be used to download the video.
          - `thumbnail` DubbedAssetThumbnail, required
            - `image` string, nullable — A time-limited URL which may be used to download the video thumbnail.
            - `gif` string, nullable — A time-limited URL which may be used to download the video animated GIF thumbnail.
          - `captions` DubbedAssetCaptions, required
            - `srt` string, nullable — A time-limited URL which may be used to download the video captions in srt format.
            - `vtt` string, nullable — A time-limited URL which may be used to download the video captions in vtt format.
        - DubbedAssetError — Dubbed asset error - minimal data + error code.
          - `id` string, uuid, required
          - `language` 'af' | 'sq' | 'am' | 'ar' | 'ar-DZ' | 'ar-BH' | 'ar-EG' | 'ar-IQ' | 'ar-JO' | 'ar-KW' | 'ar-LY' | 'ar-MA' | 'ar-QA' | 'ar-SA' | 'ar-SY' | 'ar-TN' | 'ar-AE' | 'ar-YE' | 'hy' | 'as' | 'az' | 'eu' | 'bn' | 'bs' | 'bg' | 'ca' | 'zh' | 'zh-CN' | 'zh-HK' | 'zh-TW' | 'hr' | 'cs' | 'da' | 'nl' | 'nl-BE' | 'nl-NL' | 'en' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-HK' | 'en-IN' | 'en-IE' | 'en-KE' | 'en-MX' | 'en-NZ' | 'en-NG' | 'en-PH' | 'en-SG' | 'en-ZA' | 'en-TZ' | 'en-US' | 'et' | 'fil' | 'fi' | 'fr' | 'fr-BE' | 'fr-CA' | 'fr-FR' | 'fr-CH' | 'gl' | 'ka' | 'de' | 'de-AT' | 'de-DE' | 'de-CH' | 'el' | 'gu' | 'he' | 'hi' | 'hu' | 'is' | 'id' | 'ga' | 'it' | 'ja' | 'jw' | 'kn' | 'kk' | 'km' | 'ko' | 'lo' | 'lv' | 'lt' | 'mk' | 'ms' | 'ml' | 'mt' | 'mr' | 'mn' | 'ne' | 'no' | 'nb' | 'nn' | 'or' | 'pa' | 'ps' | 'fa' | 'pl' | 'pt' | 'pt-BR' | 'pt-PT' | 'ro' | 'ru' | 'sr' | 'si' | 'sk' | 'sl' | 'so' | 'es' | 'es-AR' | 'es-BO' | 'es-CL' | 'es-CO' | 'es-CR' | 'es-CU' | 'es-DO' | 'es-EC' | 'es-SV' | 'es-GQ' | 'es-GT' | 'es-HN' | 'es-LA' | 'es-MX' | 'es-NI' | 'es-PA' | 'es-PY' | 'es-PE' | 'es-PR' | 'es-ES' | 'es-US' | 'es-UY' | 'es-VE' | 'su' | 'sw' | 'sv' | 'ta' | 'ta-IN' | 'ta-SG' | 'ta-LK' | 'te' | 'th' | 'tr' | 'uk' | 'ur' | 'uz' | 'vi' | 'cy' | 'zu', required
          - `status` 'error' — The status of the dubbed video.
          - `errorCode` 'moderation' | 'video_duration_limit_reached' | 'invalid_target_language' | 'processing_error', required
  - GetDubbingProjectVideosResponseError — Response when dubbing project encountered an error.
    - `id` string, uuid, required
    - `status` 'error' — The status of the dubbed video.
    - `errorCode` 'moderation' | 'video_duration_limit_reached' | 'invalid_target_language' | 'processing_error', required

## Other responses

- `400` — Bad Request - Invalid dubbing project.
- `403` — Forbidden - Wrong API key.
- `404` — Not Found - Feature disabled or target languages not found.
- `default` — Unexpected Server error.

---

[API](https://skmtc.net/synthesia/apis/synthesia-api.md) · [All operations](https://skmtc.net/synthesia/apis/synthesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synthesia/synthesia-api/revisions/f0f34ae0591d/schema)