---
title: "Get Suppression List"
method: GET
path: "/{WSID}/suppressions"
tags: ["Suppression List"]
---

# Get Suppression List

`GET /{WSID}/suppressions`

The Suppression List API enables you to manage users who should be excluded from receiving communications on specific channels.

This API enables you to retrieve the list of all suppressed users across various channels.

## Path parameters

- `WSID` string, required

## Response `200`

Suppression list fetched.

- FetchSuppressionList[]
  - `_id` string — Unique identifier of the suppression record
  - `destination` string — Phone number or email of the suppressed user
  - `distinct_id` string — Unique identifier (used as an alternative to destination)
  - `channel` string — Communication channel (e.g., sms, whatsapp, email)
  - `description` string — Reason or tag for suppression (e.g., "DND", "Testing").
  - `created_at` string — Timestamp when the suppression was created
  - `expiry_ts` string — Optional timestamp for expiration of suppression

## Other responses

- `401` — API Key or Workspace ID is invalid. User is unauthorised.

---

[API](https://skmtc.net/fynoio/apis/fyno-rest-api.md) · [All operations](https://skmtc.net/fynoio/apis/fyno-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fynoio/fyno-rest-api/revisions/ee288e1ee67d/schema)
