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
}