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": "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
}
}
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": "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. Theid path parameter accepts either the voice’s UUID or its name (for curated default voices like maya, derek, willow).
Headers
Your API key for authentication.
Path Parameters
Voice UUID or curated voice name. For example:
GET /v1/voices/d4610ec1-933d-44c9-a05f-53df2437808dGET /v1/voices/maya
Response
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
Was this page helpful?
⌘I