# List blocked numbers and prefixes

`GET https://app.whatsetter.com/api/v1/blocked-contacts`

The workspace's block rules, newest first. `kind=number` rules carry
the E.164 `phone` when the value is a real number (a masked WhatsApp
id has none); `kind=prefix` rules hold the dial code in `value`.
`campaign_id` is `null` for team-wide rules (every rule created through
the API), or the campaign slug when the dashboard scoped it. Requires
scope `blocklist:manage`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `kind` | query | number \| prefix | no |  |
| `limit` | query | integer | no |  |
| `cursor` | query | string | no | Opaque cursor from the previous page's `pagination.next_cursor`. |

## Example request

```bash
curl --request GET \
  --url 'https://app.whatsetter.com/api/v1/blocked-contacts' \
  --header 'Authorization: Bearer ws_live_…'
```

## Responses

### 200: The rules

```json
{
  "data": [
    {
      "id": "68f1a0b1c2d3e4f5a6b7c8d9",
      "kind": "number",
      "value": "33612345678",
      "phone": "+33612345678",
      "label": "Spammer",
      "reason": null,
      "campaign_id": null,
      "created_at": "2026-09-15T12:00:00.000Z"
    },
    {
      "id": "68f1a0b1c2d3e4f5a6b7c8da",
      "kind": "prefix",
      "value": "91",
      "phone": null,
      "label": "India",
      "reason": "Out of market",
      "campaign_id": null,
      "created_at": "2026-09-15T12:01:00.000Z"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  }
}
```

### 401: Missing, unknown or revoked API key

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 403: The key lacks the required scope (`insufficient_scope`), the plan does not have this part of the API (`not_in_plan`), or Instagram is not enabled on the workspace (`instagram_not_enabled`, Instagram routes)

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 422: Invalid parameter or body (also an invalid or expired `cursor`)

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```


Source: https://docs.whatsetter.com/api-reference/operations/listblockedcontacts/
