Skip to main content
GET
/
v1
/
voices
/
{id}
Get Voice
curl --request GET \
  --url https://api.bland.ai/v1/voices/{id} \
  --header 'authorization: <authorization>'
{
  "voice": {
    "id": "d4610ec1-933d-44c9-a05f-53df2437808d",
    "name": "maya",
    "description": "Young American Female",
    "public": true,
    "tags": ["english", "soft", "Bland Curated"],
    "user_id": null,
    "voice_id": "5134ee24-7d14-49a4-8aff-2215d295b6cc",
    "service": "BTTS_V2",
    "finetuned": false,
    "is_creator_voice": false,
    "ratings": 1234,
    "total_ratings": 1234,
    "average_rating": 4.6,
    "my_rating": null,
    "creator_display_name": null
  }
}

Overview

Returns the full record for a single voice. Same field shape as List Voices. The id path parameter accepts either the voice’s UUID or its name (for curated default voices like maya, derek, willow).

Headers

authorization
string
required
Your API key for authentication.

Path Parameters

id
string
required
Voice UUID or curated voice name. For example:
  • GET /v1/voices/d4610ec1-933d-44c9-a05f-53df2437808d
  • GET /v1/voices/maya

Response

voice
object
The voice record. See List Voices for the full field list.
{
  "voice": {
    "id": "d4610ec1-933d-44c9-a05f-53df2437808d",
    "name": "maya",
    "description": "Young American Female",
    "public": true,
    "tags": ["english", "soft", "Bland Curated"],
    "user_id": null,
    "voice_id": "5134ee24-7d14-49a4-8aff-2215d295b6cc",
    "service": "BTTS_V2",
    "finetuned": false,
    "is_creator_voice": false,
    "ratings": 1234,
    "total_ratings": 1234,
    "average_rating": 4.6,
    "my_rating": null,
    "creator_display_name": null
  }
}

Docs for agents: llms.txt