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

# List voices

`GET /tts/v1/voices`

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.net/inworld/apis/inworld-text-to-speech-api.md) · [All operations](https://skmtc.net/inworld/apis/inworld-text-to-speech-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/inworld/inworld-text-to-speech-api/versions/e79009799a0d/schema)