Skip to main content
POST
Browse the same dubbing voice catalog as the app and your saved custom dubbing voices, including playable examples and your voice slot allowance. These IDs are for video dubbing; voices_list provides the separate text-to-speech library.

Authentication and permissions

string
required
Send a VoiceCheap API key in this header. Authorization: Bearer with the same API key is also supported. OAuth access tokens are accepted only by MCP, not by this REST endpoint.
Required permissions: voices:read. An active paid subscription is required. Permissions do not change team roles, resource ownership, media credits, or plan limits.

Parameters

string
Text value.Allowed values: “en”, “fr”, “es”, “de”, “it”, “pt”, “pl”, “zh”, “ja”. Default: “en”.
string
Text value.Minimum length: 2. Maximum length: 35.
Text value.Maximum length: 100.
The JSON Schema below preserves the exact field names, nested types, defaults, bounds, and accepted values exposed by discovery. Additional cross-field rules are listed in the operation notes.

Request examples

Replace example resource identifiers and media keys with values returned for your account. Keep the request identifier stable when retrying the same mutation.

Response

A successful first execution returns HTTP 200 with the operation result under data. A replay may return saved request state instead. The example shows one supported response, not every optional field. Matching catalog and owned custom video dubbing voices, plus the current saved dubbing voice allowance.

Result fields

Operation notes

  • This is the video dubbing library. Use voices_list for the separate TTS catalog and clone:<UUID> selections.
  • locale defaults to en and accepts en, fr, es, de, it, pt, pl, zh, and ja. Missing localized text falls back to English or another available translation.
  • Optional search is a case-insensitive substring match across the voice name and localized description, with a maximum of 100 trimmed characters.
  • Optional language contains 2–35 characters and is matched exactly against catalog language or languages metadata. Voices without language metadata, including custom voices, remain included.
  • The list is not paginated. Catalog and custom voices have different optional metadata. Clone slot usage counts saved custom dubbing voices only.
  • The example filters to one owned custom voice. Its list field is previewUrl; cloning returns the same audio example under audioExampleUrl.
  • Speech history and custom voices belong to the authenticated account. Team billing does not grant access to another member’s speech or voices.

Usage

Each successful invocation consumes one monthly API/MCP call. Media credits and the operation’s own generation allowances also apply.

Errors