---
title: "List Dubs"
method: GET
path: "/v1/dubbing"
tags: ["dubbing", "dubbing", "dubbing"]
---

# List Dubs

`GET /v1/dubbing`

List the dubs you have access to.

## Query parameters

- `cursor` string, nullable — Used for fetching next page. Cursor is returned in the response.
- `page_size` integer — How many dubs to return at maximum. Can not exceed 200, defaults to 100.
- `dubbing_status` 'dubbing' | 'dubbed' | 'failed' — What state the dub is currently in.
- `dubbing_statuses` string[], nullable — Filter by dubbing status.
- `dubbing_models` string[], nullable — Filter by dubbing model generation.
- `target_language_codes` string[], nullable — Filter by target language code.
- `creation_sources` string[], nullable — Filter by dubbing creation source.
- `filter_by_creator` 'personal' | 'others' | 'all' — Filters who created the resources being listed, whether it was the user running the request or someone else that shared the resource with them.
- `order_by` 'created_at' | 'name' — The field to use for ordering results from this query.
- `order_direction` 'DESCENDING' | 'ASCENDING' — The order direction to use for results from this query.

## 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

- DubbingMetadataPageResponseModel
  - `dubs` DubbingMetadataResponse[], required
    - `dubbing_id` string, required — The ID of the dubbing project.
    - `name` string, required — The name of the dubbing project.
    - `status` string, required — The state this dub is in.
    - `source_language` string, nullable, required — Once dubbing has completed, the ISO-639-1 code of the original media's source language.
    - `target_languages` string[], required — The ISO-639-1 code of the languages this media has been dubbed into.
    - `editable` boolean — Whether this dubbing project is editable in Dubbing Studio.
    - `created_at` string, date-time, required — Timestamp this dub was created.
    - `media_metadata` DubbingMediaMetadata
      - `content_type` string, required — The content type of the media.
      - `duration` number, required — The duration of the media in seconds.
    - `error` string, nullable — Error message indicate, if this dub has failed, what happened.
  - `next_cursor` string, nullable, required
  - `has_more` boolean, required

## 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)