POST
/
v1
/
blocked_numbers
curl --request POST \
  --url https://api.bland.ai/v1/blocked_numbers \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "numbers": [
    "<string>"
  ],
  "is_global": true,
  "inbound_number": "<string>",
  "reason": "<string>"
}'
{
  "data": {
    "created_count": 1,
    "blocks": [
      {
        "id": 123,
        "blocked_number": "+10000000000",
        "is_global": true,
        "inbound_number": null,
        "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
}

Call Blocking – Blocked numbers will be rejected before reaching any agent. Blocking can apply globally or to specific inbound lines.

​
Headers

​
authorization
string
required

Your API key for authentication.

​
Body Parameters

​
numbers
string[]
required

A list of phone numbers to block, formatted in E.164 (e.g., +14155551234). Maximum 10 numbers per request.

​
is_global
boolean
required

Set to true to block the numbers globally across all inbound numbers. Set to false to scope the block to a specific inbound_number. You cannot enable both is_global and inbound_number in the same request.

​
inbound_number
string

The E.164 formatted inbound number to associate the block with. Required when is_global is false.

​
reason
string

Optional text to describe the reason for blocking.

​
Response

​
data
object

Contains the number of rules created and the list of created blocks.

​
data.created_count
number

Number of block rules successfully created.

​
data.blocks
array

List of block rule objects that were created.

​
errors
null|array

null on success, or an array of error objects if validation fails.

{
  "data": {
    "created_count": 1,
    "blocks": [
      {
        "id": 123,
        "blocked_number": "+10000000000",
        "is_global": true,
        "inbound_number": null,
        "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
}