---
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' | 'resemble' | 'xai' | 'humain'
- `api_key` string

## Response `200`

List of available voices.

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

## Other responses

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

## Changes

> 78 revisions in range; 1 not diffed.

- **2026-09-16** `a6a61a29ecdd` — 1 breaking
  - removed the enum value `rime` from the `query` request parameter `provider`
- **2026-08-17** `1571b0380bd7` — 1 info
  - added the optional property `voices/items/hosted` to the response with the `200` status
- **2026-07-23** `5eb902cacc2d` — 1 info
  - added the new enum value `humain` to the `query` request parameter `provider`

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/text-to-speech/voices/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/950384d11a37?raw)