---
title: "List voices"
method: GET
path: "/tts/v1/voices"
tags: ["TextToSpeech"]
---

# List voices

`GET /tts/v1/voices`

## Request

- Base URL: `https://api.inworld.ai`
- URL: `https://api.inworld.ai/tts/v1/voices`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/inworld/apis/inworld-text-to-speech-api/docs/tts/v1/voices/get.ts> (a function with typed inputs; its response is checked against the schema)

List all available voices based on the provided filter.

> **⚠️ Deprecation Notice**: This endpoint is deprecated. Use the [Voices API's List Voices](../../../api-reference/voiceAPI/voiceservice/list-voices) instead for new features and better performance. This API is scheduled to be removed on July 1, 2026.

## Query parameters

- `filter` string

## Response `200`

- Ttsv1ListVoicesResponse
  - `voices` Ttsv1Voice[]: The list of voices.
    - `languages` string[]: The language of the original voice audio. Speech synthesis will work best when the text matches the language of the original voice audio.
    - `voiceId` string: The ID of the voice.
    - `displayName` string: The display name of the voice.
    - `description` string: The description of the voice.
    - `tags` string[]: Tags associated with the voice.
    - `isCustom` boolean: Whether this voice is a custom voice created in your workspace (for example, a cloned voice).

## Other responses

- `4XX`: An error response.

---

[API](https://skmtc.dev/inworld/apis/inworld-text-to-speech-api.md) - [All operations](https://skmtc.dev/inworld/apis/inworld-text-to-speech-api/llms.txt) - [OpenAPI document](https://skmtc.dev/inworld/apis/inworld-text-to-speech-api/revisions/e79009799a0d?raw)