Numbers
Get Voice Pool
List the voices in an inbound number’s voice pool.
GET
/
v1
/
inbound
/
{phone_number}
/
voice-pool
Get Voice Pool
curl --request GET \
--url https://api.bland.ai/v1/inbound/{phone_number}/voice-pool \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/inbound/{phone_number}/voice-pool"
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/inbound/{phone_number}/voice-pool', 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/inbound/{phone_number}/voice-pool",
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/inbound/{phone_number}/voice-pool"
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/inbound/{phone_number}/voice-pool")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/inbound/{phone_number}/voice-pool")
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{
"data": {
"voice_pool": [
{
"id": "31c0a4ee-2fab-4400-b4c1-4ac6f6abcd6f",
"voice": {
"id": "a7f58a4e-3fdb-40fd-ad8b-a14cfe136a59",
"name": "josh",
"voice_id": "TxGEqnHWrfWFTfGW9XjX",
"service": "ELEVEN"
},
"created_at": "2026-10-05T17:53:50.074Z"
},
{
"id": "48608715-a0ba-41c0-ba43-2c1c61255db1",
"voice": {
"id": "96e2b2d6-d1c2-4676-81d5-e78e9cf3fefc",
"name": "martha",
"voice_id": "wVZ5qbJFYF3snuC65nb4",
"service": "ELEVEN"
},
"created_at": "2026-10-05T17:53:50.074Z"
}
]
},
"errors": null
}
{
"data": {
"voice_pool": []
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Inbound number not found"
}
]
}
Overview
Returns the voices currently in the pool for one inbound number. When a pool is set, each inbound call picks one of these voices at random. Set the pool with Set Voice Pool. An emptyvoice_pool array means no pool is configured and the number uses its own voice setting.
Headers
Path Parameters
The inbound number to read, in E.164 format (for example
+15551234567). SIP DIDs are matched in the form they are stored, so a numeric DID such as 9994221001 also resolves.Response
Show data fields
Show data fields
One entry per voice in the pool, empty when no pool is set.
Show Pool entry fields
Show Pool entry fields
{
"data": {
"voice_pool": [
{
"id": "31c0a4ee-2fab-4400-b4c1-4ac6f6abcd6f",
"voice": {
"id": "a7f58a4e-3fdb-40fd-ad8b-a14cfe136a59",
"name": "josh",
"voice_id": "TxGEqnHWrfWFTfGW9XjX",
"service": "ELEVEN"
},
"created_at": "2026-10-05T17:53:50.074Z"
},
{
"id": "48608715-a0ba-41c0-ba43-2c1c61255db1",
"voice": {
"id": "96e2b2d6-d1c2-4676-81d5-e78e9cf3fefc",
"name": "martha",
"voice_id": "wVZ5qbJFYF3snuC65nb4",
"service": "ELEVEN"
},
"created_at": "2026-10-05T17:53:50.074Z"
}
]
},
"errors": null
}
{
"data": {
"voice_pool": []
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Inbound number not found"
}
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I
Get Voice Pool
curl --request GET \
--url https://api.bland.ai/v1/inbound/{phone_number}/voice-pool \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/inbound/{phone_number}/voice-pool"
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/inbound/{phone_number}/voice-pool', 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/inbound/{phone_number}/voice-pool",
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/inbound/{phone_number}/voice-pool"
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/inbound/{phone_number}/voice-pool")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/inbound/{phone_number}/voice-pool")
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{
"data": {
"voice_pool": [
{
"id": "31c0a4ee-2fab-4400-b4c1-4ac6f6abcd6f",
"voice": {
"id": "a7f58a4e-3fdb-40fd-ad8b-a14cfe136a59",
"name": "josh",
"voice_id": "TxGEqnHWrfWFTfGW9XjX",
"service": "ELEVEN"
},
"created_at": "2026-10-05T17:53:50.074Z"
},
{
"id": "48608715-a0ba-41c0-ba43-2c1c61255db1",
"voice": {
"id": "96e2b2d6-d1c2-4676-81d5-e78e9cf3fefc",
"name": "martha",
"voice_id": "wVZ5qbJFYF3snuC65nb4",
"service": "ELEVEN"
},
"created_at": "2026-10-05T17:53:50.074Z"
}
]
},
"errors": null
}
{
"data": {
"voice_pool": []
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Inbound number not found"
}
]
}