# Suppressions API

Manage the suppression list to prevent sending to bounced or complained addresses.

## GET /v1/suppressions

**GET** `/v1/suppressions`

List all suppressed email addresses. **Requires full-access key.** Addresses are automatically added when a permanent bounce or complaint occurs.

```response — 200 OK
{
  "suppressions": [
    {
      "id": "b8c9d0e1-cdef-4012-3456-888888888888",
      "email": "invalid@example.com",
      "reason": "BOUNCE",
      "createdAt": "2026-03-11T00:00:00.000Z"
    }
  ]
}
```


## POST /v1/suppressions

**POST** `/v1/suppressions`

Manually suppress an email address. **Requires full-access key and verified email.** Useful for proactively blocking known-bad addresses.

**Request body**

| Name | Type | Description |
|------|------|-------------|
| `email`* | `string` | Email address to suppress |
| `reason` | `"BOUNCE" \| "COMPLAINT" \| "MANUAL"` | Default: "MANUAL" |

### Errors

- `403` — Email not verified or scoped key
- `409` — Address already suppressed


## DELETE /v1/suppressions/:id

**DELETE** `/v1/suppressions/:id`

Remove a suppression, allowing sends to the address again. **Requires full-access key.** Use with caution — sending to previously bounced addresses can harm your sender reputation.

```response — 200 OK
{ "deleted": true }
```


---

Previous: [Billing](https://robotomail.com/docs/api/billing.md) | Next: [Errors](https://robotomail.com/docs/api/errors.md)