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
string
required
Your API key for authentication.
Query Parameters
integer
default:"50"
Number of voices to return.
integer
default:"0"
Pagination offset.
string
Free-text search across voice name, description, and tags.
string
Filter to voices tagged for a specific language (for example
en, es, ja).Response
array
Array of shared voices.
Show Voice fields
Show Voice fields
string
UUID of the shared voice. Pass to Add Library Voice to add it to your org.
string
Display name in the public library.
string | null
string
The voice’s underlying TTS service. Examples:
BTTS_V2, BTTS_V3.boolean
true if the voice is part of the creator program. Creator voices may carry a per-character fee in addition to the synthesis cost.number
Total number of ratings the voice has received.
number
Alias of
ratings returned for backwards compatibility.number
Average rating, 0-5.
number
Internal score used to surface trending voices in the dashboard.
string[]
string
ISO 8601 timestamp.
boolean
Always
true for entries in the shared library.string | null
Name of the creator who published the voice, if applicable.
number | null
Per-character creator fee in cents per 1,000 characters.
null for non-creator voices.number | null
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