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
}