GET
/
v1
/
blocked_numbers
/
{block_id}
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
}