Get Voice
curl --request GET \
--url https://api.bland.ai/v1/voices/{id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/voices/{id}"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/voices/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v1/voices/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/voices/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bland.ai/v1/voices/{id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"voice": {
"id": "d4610ec1-933d-44c9-a05f-53df2437808d",
"name": "Karen",
"description": "A mature female with a General American accent, nasal and deadpan, with a moderate pace, for customer support and IVR prompts.",
"public": true,
"tags": ["English", "Female", "General American", "customer support", "Bland Curated"],
"user_id": null,
"voice_id": "5134ee24-7d14-49a4-8aff-2215d295b6cc",
"service": "BTTS_V3",
"finetuned": false,
"is_creator_voice": false,
"ratings": 1234,
"total_ratings": 1234,
"average_rating": 4.6,
"my_rating": null,
"creator_display_name": null
}
}
Voices
Get Voice
Get details on a single voice.
GET
/
v1
/
voices
/
{id}
Get Voice
curl --request GET \
--url https://api.bland.ai/v1/voices/{id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/voices/{id}"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/voices/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v1/voices/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/voices/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bland.ai/v1/voices/{id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"voice": {
"id": "d4610ec1-933d-44c9-a05f-53df2437808d",
"name": "Karen",
"description": "A mature female with a General American accent, nasal and deadpan, with a moderate pace, for customer support and IVR prompts.",
"public": true,
"tags": ["English", "Female", "General American", "customer support", "Bland Curated"],
"user_id": null,
"voice_id": "5134ee24-7d14-49a4-8aff-2215d295b6cc",
"service": "BTTS_V3",
"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. Theid path parameter accepts either the voice’s UUID or its name (for curated default voices like Karen and Willow).
Headers
string
required
Your API key for authentication.
Path Parameters
string
required
Voice UUID or curated voice name. For example:
GET /v1/voices/d4610ec1-933d-44c9-a05f-53df2437808dGET /v1/voices/Karen
Response
object
The voice record. See List Voices for the full field list.
{
"voice": {
"id": "d4610ec1-933d-44c9-a05f-53df2437808d",
"name": "Karen",
"description": "A mature female with a General American accent, nasal and deadpan, with a moderate pace, for customer support and IVR prompts.",
"public": true,
"tags": ["English", "Female", "General American", "customer support", "Bland Curated"],
"user_id": null,
"voice_id": "5134ee24-7d14-49a4-8aff-2215d295b6cc",
"service": "BTTS_V3",
"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
Was this page helpful?