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>'
{
  "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

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
block_id
number
required
The unique ID of the block rule you wish to retrieve.

​
Response

​
data
object
The block rule object if found.
​
data.id
number
The unique ID of the block rule.
​
data.blocked_number
string
The E.164 formatted phone number that is blocked.
​
data.is_global
boolean
Whether the block is applied globally across all inbound numbers.
​
data.inbound_number
string|null
The specific inbound number the block applies to (if not global).
​
data.org_id
string
The UUID of the organization that owns the rule.
​
data.reason
string|null
An optional reason for the block.
​
data.is_active
boolean
Indicates whether the block is currently active.
​
data.created_at
string
ISO timestamp for when the rule was created.
​
data.updated_at
string
ISO timestamp for when the rule was last updated.
​
errors
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
}