Skip to main content
GET
/
config
/
tts-voices
List Provider Voices
curl --request GET \
  --url https://voice-livekit.studio.lyzr.ai/v1/config/tts-voices \
  --header 'x-api-key: <api-key>'
{
  "voices": [
    {
      "id": "Xb7hH8MSUJpSbSDYk0k2",
      "name": "Alice - Friendly & Professional",
      "gender": "female",
      "language": "en",
      "previewUrl": "https://example.com/audio/alice_preview.wav"
    }
  ],
  "nextCursor": "cGFnZT0y"
}
Fetch the complete, paginated catalog of voices available from a specific Text-to-Speech (TTS) provider. Whether your users want a “calm, British male” voice from ElevenLabs or an “energetic female” voice from Cartesia, this endpoint allows you to query, filter, and paginate through thousands of available voice models to find the perfect fit for your Voice Agent.
Authentication Required: You must include your API key in the x-api-key header to authenticate this request.

​
Required Parameters

  • providerId: This is the only strictly required parameter. You must specify which provider’s library you are querying (e.g., elevenlabs, cartesia, deepgram). You can get the list of active providers using the List TTS Voice Providers endpoint.

​
Searching & Filtering

If the requested provider supports search and facets (which you can verify via the provider metadata endpoint), you can use the following query parameters to narrow down the results:
  • q: A free-text search string. Pass a name or a descriptive adjective like “warm” or “news anchor”.
  • language: Pass a standard ISO code (like en or es) to only return voices natively trained for that language.
  • gender: Filter the catalog by male, female, or other provider-supported gender tags.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
providerId
enum<string>
required

The internal ID of the TTS provider to query.

Available options:
cartesia,
elevenlabs,
deepgram,
inworld,
rime,
sarvam
Example:

"elevenlabs"

​
q
string

A search query to filter voices by name or characteristic (requires the provider to support search).

Example:

"friendly"

​
language
string

Filter voices by supported language code (e.g., 'en', 'es').

Example:

"en"

​
gender
string

Filter voices by gender.

Example:

"female"

​
limit
integer

The maximum number of voices to return per page.

Example:

20

​
cursor
string

The pagination cursor to retrieve the next page of results.

Response

A paginated list of voices for the requested provider.

​
voices
object[]
​
nextCursor
string

A token used to fetch the next set of results. Null if there are no more pages.

Example:

"cGFnZT0y"