# List Slack suppressions

List suppressed Slack channel destinations for the organization.

Source: https://statusdashboard.com/docs/api/integrations/slack/suppression/list

`GET /app/integrations/slack/suppression`

Returns a paginated list of suppressed Slack channel endpoints for the organization. Entries are created after repeated delivery failures (or manually).

Requires the `admin` or `subscriber` role and the **integrations** feature entitlement.

List rows include `urlDisplay` (redacted `#channel · workspace`) — never bot tokens.

***

## Request
See [API Basics](/docs/api) for required headers.

### Query parameters
| Parameter   | Type    | Required | Description                                                                                             |
| ----------- | ------- | -------- | ------------------------------------------------------------------------------------------------------- |
| `limit`     | integer | No       | Max entries per page. Range: 1–100. Default: `10`.                                                      |
| `nextToken` | string  | No       | Next-page bookmark from the previous response — pass unchanged. See [Pagination](/docs/api#pagination). |
| `urlHash`   | string  | No       | Filter to one endpoint hash.                                                                            |

***

## Sample request
```bash
curl "https://api.statusdashboard.com/app/integrations/slack/suppression" \
  -H "Authorization: Bearer bcf847abf5c6:def456"
```

## Sample response
**Status: `200 OK`**

```json
{
  "suppressions": [
    {
      "channel": "slack",
      "urlHash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      "urlDisplay": "#incidents · Acme Workspace",
      "reason": "delivery_failures",
      "detail": "5 consecutive failures",
      "consecutiveFailures": 5,
      "suppressedAt": "2026-06-26T14:30:00.000Z",
      "lastEventAt": "2026-06-26T14:30:00.000Z",
      "managementEmail": "ops@acme.com",
      "dashboardId": "550e8400-e29b-41d4-a716-446655440000"
    }
  ],
  "nextToken": null
}
```

***

## Response fields
| Field          | Type           | Description                                                                         |
| -------------- | -------------- | ----------------------------------------------------------------------------------- |
| `suppressions` | array          | Suppression entries for this page.                                                  |
| `nextToken`    | string \| null | Next-page bookmark when more results exist. See [Pagination](/docs/api#pagination). |

### Entry fields
Each `suppressions[]` item:

| Field                 | Type              | Description                                                             |
| --------------------- | ----------------- | ----------------------------------------------------------------------- |
| `channel`             | string            | `slack`                                                                 |
| `urlHash`             | string            | Endpoint hash.                                                          |
| `urlDisplay`          | string \| omitted | Redacted `#channel · workspace` display when the identity still exists. |
| `reason`              | string            | `delivery_failures` or `manual`.                                        |
| `detail`              | string \| omitted | Human-readable summary when available.                                  |
| `consecutiveFailures` | number \| omitted | Failure count at suppress time.                                         |
| `suppressedAt`        | string            | ISO 8601 — first time this endpoint was suppressed.                     |
| `lastEventAt`         | string            | ISO 8601 — most recent event for this entry.                            |
| `managementEmail`     | string \| omitted | Management contact when recorded.                                       |
| `dashboardId`         | string \| omitted | Dashboard UUID when recorded.                                           |

***

## Pagination
See [Pagination](/docs/api#pagination) in API Basics. Re-send the same query parameters on every page request.

***

## Retention
Suppression entries **do not expire**. They remain until removed via [DELETE suppression](/docs/api/integrations/slack/suppression/delete).

***

## Error responses
| Status | When                                                         |
| ------ | ------------------------------------------------------------ |
| `400`  | Invalid query parameters.                                    |
| `403`  | Insufficient role, or integrations not enabled on your plan. |