---
title: "List your suppressed addresses"
method: GET
path: "/v1/suppressions"
tags: ["Contacts"]
---

# List your suppressed addresses

`GET /v1/suppressions`

## Request

- Base URL: `https://api.agentboxd.com`
- URL: `https://api.agentboxd.com/v1/suppressions`
- Auth: HTTP bearer

`?reason=bounce|complaint|manual&q=&cursor=&limit=` → `{ data: [{ address, reason, created_at, expires_at }], next_cursor }`, newest first. Your workspace’s suppression list: addresses that bounced (`bounce`) or reported your mail as spam (`complaint`). Your sends to them are refused (`422 recipient_suppressed`). Only rows that apply now; other workspaces’ lists are never shown. `contacts:read`, workspace-wide keys only.

Permission: `contacts:read`.

## Query parameters

- `cursor` string
- `limit` integer
- `reason` 'bounce' | 'complaint' | 'manual'
- `q` string

## Response `200`

OK

- object

## Other responses

- `4XX`: Error
- `5XX`: Error

---

[API](https://skmtc.dev/agentboxd/apis/agentboxd-api.md) · [All operations](https://skmtc.dev/agentboxd/apis/agentboxd-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentboxd/apis/agentboxd-api/revisions/ee7b079f0e97?raw)