Skip to Content
CallMitraDocs
API referenceAgents

List voices

Voices you can put on an agent, with the providers and languages they belong to. Set `config.tts` to a voice's `provider` and `config.voice` to its `voiceId`. Filters narrow `voices` only; `providers` and `languages` always list the full catalog.

GET
/api/v1/voices/

Voices you can put on an agent, with the providers and languages they belong to. Set config.tts to a voice's provider and config.voice to its voiceId. Filters narrow voices only; providers and languages always list the full catalog.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Query Parameters

provider?|

Only voices from this provider, for example sarvam.

language?|

Only voices that speak this language code, for example hi-IN.

Response Body

OK

application/json
  1. response

Active voices, providers and languages.

languages*array<>
providers*array<>
success?Success

Always true on success.

Defaulttrue
voices*array<>
[key: string]?any
Example Request
curl -X GET 'https://api.callmitra.ai/api/v1/voices/'
Example Response
{  "languages": [    {      "id": "hi-IN",      "name": "Hindi"    }  ],  "providers": [    {      "count": 12,      "id": "sarvam",      "name": "Sarvam",      "previewSupported": true    }  ],  "success": true,  "voices": [    {      "gender": "female",      "languageCodes": [        "hi-IN",        "en-IN"      ],      "name": "Anushka",      "previewSupported": true,      "provider": "sarvam",      "providerName": "Sarvam",      "sortOrder": 1,      "voiceId": "anushka"    }  ]}