AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

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.


For .NET Core and PCL this operation is only available in asynchronous form. Please refer to DescribeVoicesAsync.

Namespace: Amazon.Polly
Assembly: AWSSDK.Polly.dll
Version: 3.x.y.z


public virtual DescribeVoicesResponse DescribeVoices(
         DescribeVoicesRequest request
Type: Amazon.Polly.Model.DescribeVoicesRequest

Container for the necessary parameters to execute the DescribeVoices service method.

Return Value
The response from the DescribeVoices service method, as returned by Polly.


InvalidNextTokenException The NextToken is invalid. Verify that it's spelled correctly, and then try again.
ServiceFailureException An unknown condition has caused a service failure.


Returns the list of voices that are available for use when requesting speech synthesis. Displayed languages are those within the specified language code. If no language code is specified, voices for all available languages are displayed.

To describe available voices

var response = client.DescribeVoices(new DescribeVoicesRequest 
    LanguageCode = "en-GB"

List voices = response.Voices;


Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also