---
title: "List available voices"
method: GET
path: "/text-to-speech/voices"
tags: ["Text To Speech Commands"]
---

# List available voices

`GET /text-to-speech/voices`

Retrieve a list of available voices from one or all TTS providers. When `provider` is specified, returns voices for that provider only. Otherwise, returns voices from all providers.

Some providers (ElevenLabs, Resemble) require an API key to list voices.

## Query parameters

- `provider` 'aws' | 'telnyx' | 'azure' | 'elevenlabs' | 'minimax' | 'rime' | 'resemble' | 'xai' | 'humain'
- `api_key` string

## Response `200`

List of available voices.

- VoicesResponse — List of available voices.
  - `voices` Voice[]
    - `gender` string — Voice gender.
    - `hosted` boolean — Whether this voice runs on Telnyx-hosted infrastructure (`true`) or is provided by a third-party vendor (`false`).
    - `language` string — Language code.
    - `name` string — Voice name.
    - `provider` string — The TTS provider.
    - `voice_id` string — Voice identifier.

## Other responses

- `400` — Bad request — invalid provider or missing required API key.
- `401` — Authentication failed — missing or invalid API key.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/ec31f78cf002/schema)