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
string
required
Your API key for authentication.
Path Parameters
string
required
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
object
Show data fields
Show data fields
array
One entry per voice in the pool, empty when no pool is set.
Show Pool entry fields
Show Pool entry fields
string
The pool entry’s own ID. This identifies the membership, not the voice.
object
string
When the voice was added to the pool, ISO 8601.
null | array
null on success, or a list of error objects if the request failed.{
"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"
}
]
}