> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Block Rules

> Retrieve block rules associated with your inbound numbers.

> [!NOTE]
>
> **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.

```json Response theme={null}
{
  "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
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.