GET
/
v1
/
voices
List Voices
curl --request GET \
  --url https://api.bland.ai/v1/voices \
  --header 'authorization: <authorization>'
{
    "voices": [
        {
            "id": "2f9fdbc7-4bf2-4792-8a18-21ce3c93978f",
            "name": "maya",
            "description": "Young American Female",
            "public": true,
            "tags": [
                "english",
                "soft",
                "Bland Curated"
            ]
        },
        {
            "id": "37b3f1c8-a01e-4d70-b251-294733f08371",
            "name": "ryan",
            "description": "Professional American Male",
            "public": true,
            "tags": [
                "english",
                "Bland Curated"
            ]
        },
        {
            "id": "90295ec4-f0fe-4783-ab33-8b997ddc3ae4",
            "name": "mason",
            "description": "American Male",
            "public": true,
            "tags": [
                "english",
                "Bland Curated"
            ]
        },
        {
            "id": "bbeabae6-ec8d-444f-92ad-c8e620d3de8d",
            "name": "tina",
            "description": "Gentle American Female",
            "public": true,
            "tags": [
                "english",
                "gentle"
            ]
        },
        //...
    ]
}

Headers

authorization
string
required
Your API key for authentication.

Response

voices
array
Contains a list of the voices available for your account.
voices[].id
string
The unique identifier for the voice.
voices[].name
string
The name of the voice. This value can also be used in the voice parameter when sending calls.
voices[].description
string
A brief description of the voice.
voices[].public
boolean
Indicates whether the voice is publicly available or specific to your account.
voices[].tags
array
A list of tags that describe the voice. We recommend “Bland Curated” voices for the best quality over the phone.
voices[].total_ratings
number
The number of ratings the voice has received.
voices[].average_rating
number
The average rating of the voice, out of 5.
Note: Ratings are under development at this time and may display incomplete/inaccurate data.
{
    "voices": [
        {
            "id": "2f9fdbc7-4bf2-4792-8a18-21ce3c93978f",
            "name": "maya",
            "description": "Young American Female",
            "public": true,
            "tags": [
                "english",
                "soft",
                "Bland Curated"
            ]
        },
        {
            "id": "37b3f1c8-a01e-4d70-b251-294733f08371",
            "name": "ryan",
            "description": "Professional American Male",
            "public": true,
            "tags": [
                "english",
                "Bland Curated"
            ]
        },
        {
            "id": "90295ec4-f0fe-4783-ab33-8b997ddc3ae4",
            "name": "mason",
            "description": "American Male",
            "public": true,
            "tags": [
                "english",
                "Bland Curated"
            ]
        },
        {
            "id": "bbeabae6-ec8d-444f-92ad-c8e620d3de8d",
            "name": "tina",
            "description": "Gentle American Female",
            "public": true,
            "tags": [
                "english",
                "gentle"
            ]
        },
        //...
    ]
}