List TTS voices
Return TTS voices the authenticated account is allowed to use.
Endpoint: POST https://<base>/api/v2/GetTTSVoices.php
Returns the list of TTS voices available to the authenticated customer. The list is filtered by the cdwv_aut_cdcs_id column on cd_wav_voices — voices flagged for 0 (universal) or for this specific cdcs_id are returned.
Pass cdwv_short as it comes (for example Google|pt-BR-Wavenet-A) as the voice parameter of MakeTTSCall, CreateCampaign and CreateAudioFile. It already carries the provider: do not add cdwv_company in front of it, and do not combine the provider of one voice with the name of another. A voice that is not in this list is rejected with code 209.
Authentication
Token authentication required. See Authentication.
Request
tsid — type: string — required
Token for the account.
This endpoint takes no other parameters.
Request example
```bash curl
curl -X POST ‘https://
-H ‘Content-Type: application/json’
-d ‘{ “tsid”: “YOUR_TSID” }’
## Response
```json 200 OK
{
"return": {
"status": "OK",
"status_code": "0"
},
"voices": [
{
"cdwv_id": 52,
"cdwv_name": "Rosana N",
"cdwv_tit": "Português BR - TTS (G)",
"cdwv_short": "Google|pt-BR-Wavenet-A",
"cdwv_type": "tts",
"cdwv_language": "pt-BR",
"cdwv_genre": "female",
"cdwv_company": "Google",
"cdwv_sample": "tf708861868"
}
]
}
-
voices[].cdwv_short(string) — Voice id — pass it unchanged as thevoiceparameter inMakeTTSCall. UsuallyProvider|VoiceName, but not always: the default voicesfadandfelhave no provider, and Polly neural voices carry a third part (Polly|Camila|neural). Do not split or rebuild it. -
voices[].cdwv_name(string) — Display name of the voice (e.g.Rosana N). Not accepted asvoice. -
voices[].cdwv_sample(string) — Audio id of a short sample of the voice, useful for previewing. -
voices[].cdwv_genre(string) — Voice gender hint:femaleormale.
Error codes
This endpoint inherits the global authentication codes. It does not raise endpoint-specific business codes.
Note ElevenLabs voices may appear in this list but are blocked by
MakeTTSCall,CreateCampaignandCreateAudioFile— using them returns code210.