---
title: "List Dubbing Projects"
method: GET
path: "/v1/dubbing/project"
tags: ["Dubbing"]
---

# List Dubbing Projects

`GET /v1/dubbing/project`

List the workspace's dubbing projects (cursor-paginated).

## Query parameters

- `cursor` string, nullable — Pagination cursor from a previous response's next_cursor.
- `page_size` integer — Number of projects per page (max 100).
- `status` string, nullable — Filter to projects in this status (preparing, ready, failed).
- `sort_direction` 'ASCENDING' | 'DESCENDING' — Sort by creation time (default 'DESCENDING').

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- DubbingProjectListResponse
  - `projects` DubbingProjectResponse[], required — The page of dubbing projects the caller can access.
    - `project_id` string, required — Unique identifier of the dubbing project.
    - `status` 'queued' | 'preparing' | 'processing' | 'ready' | 'failed', required — Lifecycle status of the project: 'preparing'/'processing' while it transcribes, 'ready' once transcription is done, or 'failed'.
    - `reference` string, nullable — Optional free-form string the customer can provide to identify the project on their end.
    - `source_language` string, nullable — BCP-47 language tag of the source media (null if auto-detected).
    - `model_id` string, nullable — Default dubbing model id applied to this project's language targets.
    - `media` DubbingSourceMediaInfo — Metadata about the project's source media.
      - `filename` string, nullable — Original filename of the uploaded source media (null for URL sources).
      - `duration_s` number, nullable — Duration of the source media in seconds.
      - `has_video` boolean, nullable — Whether the source media contains a video stream.
      - `mime_type` string, nullable — MIME type of the uploaded source media.
    - `language_ids` string[] — Identifiers of the language targets created under this project.
    - `webhook_ids` string[] — Workspace webhooks notified when this project becomes ready or fails, and when any of its languages completes or fails.
    - `revision` integer, required — Monotonic counter incremented whenever the source transcript is edited (segment add/edit/delete).
    - `error` DubbingError
      - `code` string, required — Stable identifier for the failure, safe to branch on. New codes are added over time, so treat an unrecognized value as 'internal_error'.
      - `message` string, required — Human-readable description of the failure, for display. The wording may change at any time; branch on `code` instead.
      - `retryable` boolean, required — Whether resubmitting the same input could succeed. False means the failure describes the input or the account, so an identical retry will fail the same way.
    - `warnings` VoicesNotPermittedWarning[] — 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.
      - `type` 'voices_not_permitted', required — Identifies this warning; branch on it to read the fields below.
      - `speaker_ids` string[], required — Speakers whose voices were not permitted for cloning. The dub used a replacement voice for each of them; the rest of the speakers are unaffected.
      - `message` string, required — Human-readable description of the warning, for display. The wording may change at any time; branch on `type` instead.
    - `created_at` string, date-time, required — When the project was created.
    - `updated_at` string, date-time, required — When the project was last updated.
  - `next_cursor` string, nullable — Cursor for the next page, or null when there are no more results.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/versions/57d56f34628a/schema)