GET
/
v1
/
voices
curl --request GET \
  --url https://api.bland.ai/v1/voices \
  --header 'authorization: <authorization>'
{
    "voices": [
        {
            "voice_id": 2,
            "name": "jen-english",
            "is_custom": false,
            "reduce_latency": true
        },
        {
            "voice_id": 0,
            "name": "matt",
            "is_custom": false,
            "reduce_latency": true
        },
        {
            "voice_id": 1485,
            "name": "My Custom Voice Clone",
            "is_custom": true,
            "reduce_latency": true
        },
        //...
    ],
    "presets": [
        {
            "voice_preset_id": "857ed371-9b28-4006-99da-a28c41c6fa55",
            "voice_name": "sophie-australian",
            //...
        },
        {
            "voice_preset_id": "ff2c405b-3dba-41e0-9261-bc8ee3f91f46",
            "voice_name": "david",
            //...
        },
        //...
    ]
}

Headers

authorization
string
required

Your API key for authentication.

Query Parameters

default_only
boolean

Filter to show only default presets, excluding user-created presets.

presets_only
boolean

Filter to show only presets.

voices_only
boolean

Filter to show only voices.

is_custom
boolean

Filter for custom voices.

name
string

Filters the voices array by the name of the voice.

voice_name
string

Filters the presets array by the name of the voice.

voice_id
integer

Filter by the ID of the voice.

reduce_latency
boolean

Filter by latency reduction option. Use in tandem with reduce_latency to simulate exactly which voice your agent would use.

public
boolean

Filter to show only public presets, or set to false to exclude them.

editable
boolean

Filter to show only editable presets.

Response

voices
array

Contains a list of the voices available for your account, including custom and default presets.

presets
object

Contains a list of presets with their details. Each preset object includes voice_preset_id, voice_name, description, reduce_latency, interruption_threshold, language, voice_settings, editable, and public.