Blocked Numbers
List Block Rules
Retrieve block rules associated with your inbound numbers.
GET
/
v1
/
blocked_numbers
List Block Rules
curl --request GET \
--url https://api.bland.ai/v1/blocked_numbers \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/blocked_numbers"
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/blocked_numbers', 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/blocked_numbers",
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/blocked_numbers"
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/blocked_numbers")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/blocked_numbers")
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": {
"blocks": [
{
"id": 456,
"blocked_number": "+10000000000",
"is_global": false,
"inbound_number": "+19999999999",
"org_id": "1a2b3c4d-5e6f-7a8b-9c0d-ef1234567890",
"reason": null,
"is_active": true,
"created_at": "2025-01-01T00:00:00.000Z",
"updated_at": "2025-01-01T00:00:00.000Z"
}
],
"total_count": 1,
"filters": {
"inbound_number": "+19999999999",
"active_only": true
}
},
"errors": null
}
Block Rule Management – This endpoint returns block rules for either all global blocks or a specific inbound number, depending on the query parameters.
Headers
Query Parameters
The E.164 formatted inbound number to filter results by. If omitted, returns only global block rules.
Whether to only return currently active block rules. Default is
true. Set to false to include deleted or inactive rules.Response
{
"data": {
"blocks": [
{
"id": 456,
"blocked_number": "+10000000000",
"is_global": false,
"inbound_number": "+19999999999",
"org_id": "1a2b3c4d-5e6f-7a8b-9c0d-ef1234567890",
"reason": null,
"is_active": true,
"created_at": "2025-01-01T00:00:00.000Z",
"updated_at": "2025-01-01T00:00:00.000Z"
}
],
"total_count": 1,
"filters": {
"inbound_number": "+19999999999",
"active_only": true
}
},
"errors": null
}
Docs for agents: llms.txt
Was this page helpful?
⌘I
List Block Rules
curl --request GET \
--url https://api.bland.ai/v1/blocked_numbers \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/blocked_numbers"
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/blocked_numbers', 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/blocked_numbers",
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/blocked_numbers"
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/blocked_numbers")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/blocked_numbers")
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": {
"blocks": [
{
"id": 456,
"blocked_number": "+10000000000",
"is_global": false,
"inbound_number": "+19999999999",
"org_id": "1a2b3c4d-5e6f-7a8b-9c0d-ef1234567890",
"reason": null,
"is_active": true,
"created_at": "2025-01-01T00:00:00.000Z",
"updated_at": "2025-01-01T00:00:00.000Z"
}
],
"total_count": 1,
"filters": {
"inbound_number": "+19999999999",
"active_only": true
}
},
"errors": null
}