GET
/
v1
/
blocked_numbers
curl --request GET \
  --url https://api.bland.ai/v1/blocked_numbers \
  --header 'authorization: <authorization>'
{
  "data": {
    "blocks": [
      {
        "id": 456,
        "blocked_number": "+10000000000",
        "is_global": false,
        "inbound_number": "+19999999999",
        "org_id": "1a2b3c4d-5e6f-7a8b-9c0d-ef1234567890",
        "reason": null,
        "is_active": true,
        "created_at": "2025-01-01T00:00:00.000Z",
        "updated_at": "2025-01-01T00:00:00.000Z"
      }
    ],
    "total_count": 1,
    "filters": {
      "inbound_number": "+19999999999",
      "active_only": true
    }
  },
  "errors": null
}

Block Rule Management – This endpoint returns block rules for either all global blocks or a specific inbound number, depending on the query parameters.

Headers

authorization
string
required

Your API key for authentication.

Query Parameters

inbound_number
string

The E.164 formatted inbound number to filter results by. If omitted, returns only global block rules.

active_only
boolean

Whether to only return currently active block rules. Default is true. Set to false to include deleted or inactive rules.

Response

data
object

Returns a list of block rules that match the provided filters.

data.blocks
array

Array of block rule objects.

data.total_count
number

The number of block rules returned by this request.

data.filters
object

Echoes the filters used in the request (inbound_number, active_only).

errors
null|array

null on success, or a list of error objects if validation fails.

{
  "data": {
    "blocks": [
      {
        "id": 456,
        "blocked_number": "+10000000000",
        "is_global": false,
        "inbound_number": "+19999999999",
        "org_id": "1a2b3c4d-5e6f-7a8b-9c0d-ef1234567890",
        "reason": null,
        "is_active": true,
        "created_at": "2025-01-01T00:00:00.000Z",
        "updated_at": "2025-01-01T00:00:00.000Z"
      }
    ],
    "total_count": 1,
    "filters": {
      "inbound_number": "+19999999999",
      "active_only": true
    }
  },
  "errors": null
}