Get Block Rule
curl --request GET \
--url https://api.bland.ai/v1/blocked_numbers/{block_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/blocked_numbers/{block_id}"
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/{block_id}', 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/{block_id}",
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/{block_id}"
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/{block_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/blocked_numbers/{block_id}")
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": {
"id": 123,
"blocked_number": "+10000000000",
"is_global": false,
"inbound_number": "+18888888888",
"org_id": "b7d3e9fc-5c4a-4c2a-9b8f-d1e1d1a2e333",
"reason": null,
"is_active": true,
"created_at": "2025-01-01T00:00:00.000Z",
"updated_at": "2025-01-01T00:00:00.000Z"
},
"errors": null
}
Blocked Numbers
Get Block Rule
Retrieve the details of a specific block rule.
GET
/
v1
/
blocked_numbers
/
{block_id}
Get Block Rule
curl --request GET \
--url https://api.bland.ai/v1/blocked_numbers/{block_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/blocked_numbers/{block_id}"
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/{block_id}', 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/{block_id}",
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/{block_id}"
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/{block_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/blocked_numbers/{block_id}")
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": {
"id": 123,
"blocked_number": "+10000000000",
"is_global": false,
"inbound_number": "+18888888888",
"org_id": "b7d3e9fc-5c4a-4c2a-9b8f-d1e1d1a2e333",
"reason": null,
"is_active": true,
"created_at": "2025-01-01T00:00:00.000Z",
"updated_at": "2025-01-01T00:00:00.000Z"
},
"errors": null
}
Headers
string
required
Your API key for authentication.
Path Parameters
number
required
The unique ID of the block rule you wish to retrieve.
Response
object
The block rule object if found.
number
The unique ID of the block rule.
string
The E.164 formatted phone number that is blocked.
boolean
Whether the block is applied globally across all inbound numbers.
string|null
The specific inbound number the block applies to (if not global).
string
The UUID of the organization that owns the rule.
string|null
An optional reason for the block.
boolean
Indicates whether the block is currently active.
string
ISO timestamp for when the rule was created.
string
ISO timestamp for when the rule was last updated.
null|array
null on success, or a list of error objects if the block ID is invalid or not found.{
"data": {
"id": 123,
"blocked_number": "+10000000000",
"is_global": false,
"inbound_number": "+18888888888",
"org_id": "b7d3e9fc-5c4a-4c2a-9b8f-d1e1d1a2e333",
"reason": null,
"is_active": true,
"created_at": "2025-01-01T00:00:00.000Z",
"updated_at": "2025-01-01T00:00:00.000Z"
},
"errors": null
}
Docs for agents: llms.txt
Was this page helpful?