---
title: "View suppressions"
method: POST
path: "/suppression/view"
tags: ["SUPPRESSIONS"]
---

# View suppressions

`POST /suppression/view`

Returns your suppressed email addresses and domains

## Request body

- object
  - `continue_token` string — If returned from a request this can be passed to continue paging through the result of the results
  - `email_address` string — If provided, checks if a specific email address or domain is in the block list
  - `end_date` string — ISO-8601 formatted datetime which defaults to 30 days prior to the current date at midnight. Timezone is UTC
  - `fuzzy` boolean — Indicates if the search should use fuzzy matching on recipients & reasons
  - `reason` string — A reason string to search for
  - `reasons` string[] — An array of reason strings to search for
  - `recipient` string — A recipient string to search for
  - `recipients` string[] — An array of recipient strings to search for
  - `sort` string — The direction to sort the results, either <code>asc</code> or <code>desc</code>
  - `start_date` string — ISO-8601 formatted datetime which defaults to the current date at midnight. Timezone is UTC
  - `suppression_type` string — If passed restricts the search to a single suppression type <code>manual</code>, <code>spam</code>, <code>unsubscribe</code>, <code>bounce</code> or <code>compliance</code>
  - `suppression_types` string[] — If passed restricts the search to multiple suppression types <code>manual</code>, <code>spam</code>, <code>unsubscribe</code>, <code>bounce</code> or <code>compliance</code>
  - `wildcard` string — If provided, only suppressions with this wildcard string in name, domain, or email address fields, will be returned
  - `subaccount_id` string — If you wish to make this API call on behalf of a subaccount then include its unique ID here

## Response `200`

List of suppressions

- object
  - `request_id` string, required
  - `data` object, required
    - `results` object[], required
      - `complaint` string, required
      - `reason` string, required
      - `block_description` string, required
      - `timestamp` string, required
      - `email_address` string, required
    - `continue_token` string, nullable, required
    - `total_results` integer, required

## Other responses

- `400` — 400

---

[API](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4.md) · [All operations](https://skmtc.net/smtp2go/apis/smtp2go-api-v3-0-4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smtp2go/smtp2go-api-v3-0-4/versions/1ba6b25eebb9/schema)