Get project

GET

/v1/dubbing/project/:project_id

GET

/v1/dubbing/project/:project_id

$ curl https://api.elevenlabs.io/v1/dubbing/project/proj_1601kwkyxp0hfzvtmyxwqxx6mcy3

1 {
2   "project_id": "proj_1601kwkyxp0hfzvtmyxwqxx6mcy3",
3   "status": "ready",
4   "revision": 3,
5   "created_at": "2026-07-03T10:15:30Z",
6   "updated_at": "2026-07-03T10:17:12Z",
7   "reference": "Q3 marketing video",
8   "source_language": "en",
9   "model_id": "dubbing_v2",
10   "media": {
11     "filename": "promo.mp4",
12     "duration_s": 42.5,
13     "has_video": true,
14     "mime_type": "video/mp4"
15   },
16   "language_ids": [
17     "lang_1001kwkyxp0je6ktn4knsfrasx5s"
18   ],
19   "webhook_ids": [],
20   "warnings": [
21     {
22       "type": "voices_not_permitted",
23       "speaker_ids": [
24         "speaker_1"
25       ],
26       "message": "Voice cloning was not permitted for speaker speaker_1, so a replacement voice was used."
27     }
28   ]
29 }

Full project detail, including the IDs of every language target under it. To follow a project to ready, we recommend a webhook_ids subscription rather than polling this endpoint.

Path parameters

project_idstringRequired

Identifier of the dubbing project to fetch.

Response

Successful Response

project_idstring

Unique identifier of the dubbing project.

statusenum

Lifecycle status of the project: queued before the source is picked up, preparing while it is transcribed, ready once transcription is done and language targets can start, or failed. A project is never reported as processing — that value belongs to language targets.

revisioninteger

Monotonic counter incremented whenever the source transcript is edited (segment add/edit/delete).

created_atstringformat: "date-time"

When the project was created.

updated_atstringformat: "date-time"

When the project was last updated.

referencestring or nullOptional

The free-form string you supplied as reference when creating the project, or null if you supplied none.

source_languagestring or nullOptional

BCP-47 language tag of the source media (null if auto-detected).

model_idstring or nullOptional

Dubbing model every language target of this project is dubbed with. Fixed at create time and not selectable per language.

mediaobject or nullOptional

Source media metadata, populated once the source has been fetched and decoded (shortly after create, before the project is ready); null until then.

language_idslist of stringsOptionalDefaults to []

Identifiers of the language targets under this project. Populated when a single project is fetched, and on create when target_language creates one. Always empty in list responses — list the project’s language targets instead.

webhook_idslist of stringsOptionalDefaults to []

IDs of the workspace webhooks notified as this project and its languages reach ready, completed, or failed.

errorobject or nullOptional

Why the project failed; null unless status is failed. Also null for the few projects that failed before failure reporting was introduced.

warningslist of objectsOptional

Non-fatal conditions raised while preparing the source, empty when there are none. Reflects the latest preparation. Conditions raised while dubbing a particular language are reported on that language instead.

Errors

422

Unprocessable Entity Error

Path parameters

Headers

Response

Errors