List Shared Voices
curl --request GET \
--url https://api.bland.ai/v1/voices/shared \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/voices/shared"
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/shared', 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/shared",
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/shared"
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/shared")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices/shared")
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{
"voices": [
{
"id": "e657b253-ca1f-41cc-b25f-7267ae644519",
"name": "StephenD",
"description": null,
"service": "BTTS_V2",
"is_creator_voice": false,
"ratings": 12,
"rating_count": 12,
"rating_avg": 4.5,
"trending_score": 0,
"tags": ["english", "male", "cloned"],
"created_at": "2026-04-16T09:14:25.232Z",
"public": true,
"creator_display_name": null,
"creator_fee_cents_per_1k": null,
"creator_fee_cents_per_10k": null
}
]
}
Discovery
List Shared Voices
Browse the public Bland voice library.
GET
/
v1
/
voices
/
shared
List Shared Voices
curl --request GET \
--url https://api.bland.ai/v1/voices/shared \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/voices/shared"
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/shared', 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/shared",
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/shared"
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/shared")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices/shared")
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{
"voices": [
{
"id": "e657b253-ca1f-41cc-b25f-7267ae644519",
"name": "StephenD",
"description": null,
"service": "BTTS_V2",
"is_creator_voice": false,
"ratings": 12,
"rating_count": 12,
"rating_avg": 4.5,
"trending_score": 0,
"tags": ["english", "male", "cloned"],
"created_at": "2026-04-16T09:14:25.232Z",
"public": true,
"creator_display_name": null,
"creator_fee_cents_per_1k": null,
"creator_fee_cents_per_10k": null
}
]
}
Overview
Returns the catalog of publicly-shared voices in the Bland library. These are voices that other creators have published for everyone to use; they are not in your org’s library until you call Add Library Voice. Use this endpoint to power voice-picker UIs and discovery flows.Headers
Your API key for authentication.
Query Parameters
Number of voices to return.
Pagination offset.
Free-text search across voice name, description, and tags.
Filter to voices tagged for a specific language (for example
en, es, ja).Response
Array of shared voices.
Show Voice fields
Show Voice fields
UUID of the shared voice. Pass to Add Library Voice to add it to your org.
Display name in the public library.
The voice’s underlying TTS service. Examples:
BTTS_V2, BTTS_V3.true if the voice is part of the creator program. Creator voices may carry a per-character fee in addition to the synthesis cost.Total number of ratings the voice has received.
Alias of
ratings returned for backwards compatibility.Average rating, 0-5.
Internal score used to surface trending voices in the dashboard.
ISO 8601 timestamp.
Always
true for entries in the shared library.Name of the creator who published the voice, if applicable.
Per-character creator fee in cents per 1,000 characters.
null for non-creator voices.Per-character creator fee in cents per 10,000 characters.
null for non-creator voices.{
"voices": [
{
"id": "e657b253-ca1f-41cc-b25f-7267ae644519",
"name": "StephenD",
"description": null,
"service": "BTTS_V2",
"is_creator_voice": false,
"ratings": 12,
"rating_count": 12,
"rating_avg": 4.5,
"trending_score": 0,
"tags": ["english", "male", "cloned"],
"created_at": "2026-04-16T09:14:25.232Z",
"public": true,
"creator_display_name": null,
"creator_fee_cents_per_1k": null,
"creator_fee_cents_per_10k": null
}
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I