---
title: "GET /v1/voices"
method: GET
path: "/v1/voices"
---

# GET /v1/voices

`GET /v1/voices`

Returns the list of voices that are available for use when requesting speech synthesis. Each voice speaks a specified language, is either male or female, and is identified by an ID, which is the ASCII version of the voice name.

When synthesizing speech ( `SynthesizeSpeech` ), you provide the voice ID for the voice you want from the list of voices returned by `DescribeVoices`.

For example, you want your news reader application to read news in a specific language, but giving a user the option to choose the voice. Using the `DescribeVoices` operation you can provide the user with a list of available voices to select from.

You can optionally specify a language code to filter the available voices. For example, if you specify `en-US`, the operation returns a list of all available US English voices.

This operation requires permissions to perform the `polly:DescribeVoices` action.

## Query parameters

- `Engine` 'standard' | 'neural'
- `LanguageCode` 'arb' | 'cmn-CN' | 'cy-GB' | 'da-DK' | 'de-DE' | 'en-AU' | 'en-GB' | 'en-GB-WLS' | 'en-IN' | 'en-US' | 'es-ES' | 'es-MX' | 'es-US' | 'fr-CA' | 'fr-FR' | 'is-IS' | 'it-IT' | 'ja-JP' | 'hi-IN' | 'ko-KR' | 'nb-NO' | 'nl-NL' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ro-RO' | 'ru-RU' | 'sv-SE' | 'tr-TR' | 'en-NZ' | 'en-ZA' | 'ca-ES' | 'de-AT' | 'yue-CN' | 'ar-AE' | 'fi-FI'
- `IncludeAdditionalLanguageCodes` boolean
- `NextToken` string

## Response `200`

Success

- DescribeVoicesOutput
  - `Voices` Voice[] — A list of voices with their properties.
    - `Gender` 'Female' | 'Male' — Gender of the voice.
    - `Id` 'Aditi' | 'Amy' | 'Astrid' | 'Bianca' | 'Brian' | 'Camila' | 'Carla' | 'Carmen' | 'Celine' | 'Chantal' | 'Conchita' | 'Cristiano' | 'Dora' | 'Emma' | 'Enrique' | 'Ewa' | 'Filiz' | 'Gabrielle' | 'Geraint' | 'Giorgio' | 'Gwyneth' | 'Hans' | 'Ines' | 'Ivy' | 'Jacek' | 'Jan' | 'Joanna' | 'Joey' | 'Justin' | 'Karl' | 'Kendra' | 'Kevin' | 'Kimberly' | 'Lea' | 'Liv' | 'Lotte' | 'Lucia' | 'Lupe' | 'Mads' | 'Maja' | 'Marlene' | 'Mathieu' | 'Matthew' | 'Maxim' | 'Mia' | 'Miguel' | 'Mizuki' | 'Naja' | 'Nicole' | 'Olivia' | 'Penelope' | 'Raveena' | 'Ricardo' | 'Ruben' | 'Russell' | 'Salli' | 'Seoyeon' | 'Takumi' | 'Tatyana' | 'Vicki' | 'Vitoria' | 'Zeina' | 'Zhiyu' | 'Aria' | 'Ayanda' | 'Arlet' | 'Hannah' | 'Arthur' | 'Daniel' | 'Liam' | 'Pedro' | 'Kajal' | 'Hiujin' | 'Laura' | 'Elin' | 'Ida' | 'Suvi' | 'Ola' | 'Hala' | 'Andres' | 'Sergio' | 'Remi' | 'Adriano' | 'Thiago' | 'Ruth' | 'Stephen' | 'Kazuha' | 'Tomoko' — Amazon Polly assigned voice ID. This is the ID that you specify when calling the <code>SynthesizeSpeech</code> operation.
    - `LanguageCode` 'arb' | 'cmn-CN' | 'cy-GB' | 'da-DK' | 'de-DE' | 'en-AU' | 'en-GB' | 'en-GB-WLS' | 'en-IN' | 'en-US' | 'es-ES' | 'es-MX' | 'es-US' | 'fr-CA' | 'fr-FR' | 'is-IS' | 'it-IT' | 'ja-JP' | 'hi-IN' | 'ko-KR' | 'nb-NO' | 'nl-NL' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ro-RO' | 'ru-RU' | 'sv-SE' | 'tr-TR' | 'en-NZ' | 'en-ZA' | 'ca-ES' | 'de-AT' | 'yue-CN' | 'ar-AE' | 'fi-FI' — Language code of the voice.
    - `LanguageName` string — Human readable name of the language in English.
    - `Name` string — Name of the voice (for example, Salli, Kendra, etc.). This provides a human readable voice name that you might display in your application.
    - `AdditionalLanguageCodes` LanguageCode[] — <p>Additional codes for languages available for the specified voice in addition to its default language. </p> <p>For example, the default language for Aditi is Indian English (en-IN) because it was first used for that language. Since Aditi is bilingual and fluent in both Indian English and Hindi, this parameter would show the code <code>hi-IN</code>.</p>
    - `SupportedEngines` Engine[] — Specifies which engines (<code>standard</code> or <code>neural</code>) that are supported by a given voice.
  - `NextToken` string — The pagination token to use in the next request to continue the listing of voices. <code>NextToken</code> is returned only if the response is truncated.

## Other responses

- `480` — InvalidNextTokenException
- `481` — ServiceFailureException

---

[API](https://skmtc.net/aws/apis/polly.md) · [All operations](https://skmtc.net/aws/apis/polly/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/polly/versions/0cd8445cb96a/schema)