Numbers
Number Details
Retrieve settings for your inbound phone number.
GET
/
v1
/
inbound
/
{phone_number}
Number Details
curl --request GET \
--url https://api.bland.ai/v1/inbound/{phone_number} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/inbound/{phone_number}"
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}', 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}",
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}"
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}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/inbound/{phone_number}")
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{
"created_at": "2023-11-27T17:21:38.33359+00:00",
"phone_number": "+18584139939",
"prompt": "You're Blandie, the helpful AI assistant. The person calling you has inquired...",
"webhook": "https://webhook.site/0a0a0a0a-0a0a-0a0a-0a0a-0a0a0a0a0a0",
"voice_id": 2,
"dynamic_data": null,
"max_duration": 30
}
Headers
Path Parameters
The inbound phone number to update.Formatting notes:
- The
'+'or'%2B'prefix is optional. - Will assume a US country code if no country code is provided.
+13334445555:%2B13334445555133344455553334445555
Response
The
voice your agent is currently using.For more information, see List Voices.The background track your agent is using.Will be
null by default, until an option such as office, cafe, restaurant, or none is applied.A pre-configured phone number used as a forwarding destination during Bland maintenance windows. Does not affect normal call routing. Returns
null if no fallback is configured.{
"created_at": "2023-11-27T17:21:38.33359+00:00",
"phone_number": "+18584139939",
"prompt": "You're Blandie, the helpful AI assistant. The person calling you has inquired...",
"webhook": "https://webhook.site/0a0a0a0a-0a0a-0a0a-0a0a-0a0a0a0a0a0",
"voice_id": 2,
"dynamic_data": null,
"max_duration": 30
}
Docs for agents: llms.txt
Was this page helpful?
⌘I
Number Details
curl --request GET \
--url https://api.bland.ai/v1/inbound/{phone_number} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/inbound/{phone_number}"
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}', 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}",
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}"
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}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/inbound/{phone_number}")
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{
"created_at": "2023-11-27T17:21:38.33359+00:00",
"phone_number": "+18584139939",
"prompt": "You're Blandie, the helpful AI assistant. The person calling you has inquired...",
"webhook": "https://webhook.site/0a0a0a0a-0a0a-0a0a-0a0a-0a0a0a0a0a0",
"voice_id": 2,
"dynamic_data": null,
"max_duration": 30
}