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

# List Suppressions

> Per-workspace 'do not contact' entries by channel (email, SMS, etc.). Suppressions block sends to a destination (email/phone) regardless of templates or subscriptions, used for opt-outs, bounces/complaints, and compliance.

## Method

`GET` `/v1/comms/suppressions`

## Query Parameters

<ParamField query="channel" type="string">`email`, `sms`, `whatsapp`, `telegram`, `facebook_messenger`, `instagram_dm`, `twitter_dm`, `linkedin_message`, `phone`, `push_notification`, `in_app`, `webhook`</ParamField>

## Headers

<ParamField header="Authorization" type="string" required>Bearer token (e.g. <code>Authorization: Bearer YOUR\_API\_KEY</code>)</ParamField>
<ParamField header="X-Workspace-Id" type="string" required>Workspace identifier (UUID)</ParamField>

## Request Example

<RequestExample>
  <CodeGroup>
    ```bash cURL theme={null}
    curl "https://api.voyantcloud.com/v1/comms/suppressions?channel=email" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "X-Workspace-Id: WORKSPACE_UUID"
    ```

    ```javascript Node.js theme={null}
    await fetch("https://api.voyantcloud.com/v1/comms/suppressions?channel=email", {
      headers: { Authorization: `Bearer ${process.env.VOYANT_API_KEY}`, "X-Workspace-Id": process.env.WORKSPACE_ID },
    })
    ```

    ```python Python theme={null}
    import os, requests
    requests.get(
      "https://api.voyantcloud.com/v1/comms/suppressions",
      params={"channel":"email"},
      headers={"Authorization": f"Bearer {os.environ['VOYANT_API_KEY']}", "X-Workspace-Id": os.environ["WORKSPACE_ID"]}
    )
    ```
  </CodeGroup>
</RequestExample>

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  { "data": [ { "id": "sup_123", "channel": "email", "value": "user@example.com", "reason": "bounce" } ] }
  ```
</ResponseExample>