# Suppressions API

> List, add and remove suppressed addresses.

Source: https://mailvina.com/docs/api-reference/suppressions · Base URL: https://api.mailvina.com · Guide: https://mailvina.com/docs/suppressions

## List suppressions

Lists up to 500 suppressed addresses, newest first.

`GET /suppressions`

**Request**

```bash
curl -X GET 'https://api.mailvina.com/suppressions' \
  -H 'Authorization: Bearer mv_xxxxxxxxx'
```

```js
const res = await fetch('https://api.mailvina.com/suppressions', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.MAILVINA_API_KEY}`,
  },
});
const data = await res.json();
```

```python
import os, requests

res = requests.get(
    "https://api.mailvina.com/suppressions",
    headers={"Authorization": f"Bearer {os.environ['MAILVINA_API_KEY']}"},
)
print(res.json())
```

**Response**

```json
{
  "object": "list",
  "data": [
    {
      "email": "old@example.com",
      "reason": "bounce",
      "created_at": "2026-11-14T10:00:00.000Z"
    }
  ]
}
```

## Add suppression

Suppresses an address so it never receives email from your team.

`POST /suppressions`

**Body parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `email` | `string` | yes | Address to suppress. |

**Request**

```bash
curl -X POST 'https://api.mailvina.com/suppressions' \
  -H 'Authorization: Bearer mv_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "no-mail@example.com"
}'
```

```js
const res = await fetch('https://api.mailvina.com/suppressions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MAILVINA_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "email": "no-mail@example.com"
  }),
});
const data = await res.json();
```

```python
import os, requests

res = requests.post(
    "https://api.mailvina.com/suppressions",
    headers={"Authorization": f"Bearer {os.environ['MAILVINA_API_KEY']}"},
    json={
        "email": "no-mail@example.com"
    },
)
print(res.json())
```

**Response**

```json
{
  "email": "no-mail@example.com"
}
```

## Remove suppression

Removes an address from the list so it can receive email again.

`DELETE /suppressions/:email`

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `email` | `string` | yes | URL-encoded address. |

**Request**

```bash
curl -X DELETE 'https://api.mailvina.com/suppressions/:email' \
  -H 'Authorization: Bearer mv_xxxxxxxxx'
```

```js
const res = await fetch('https://api.mailvina.com/suppressions/:email', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.MAILVINA_API_KEY}`,
  },
});
const data = await res.json();
```

```python
import os, requests

res = requests.delete(
    "https://api.mailvina.com/suppressions/:email",
    headers={"Authorization": f"Bearer {os.environ['MAILVINA_API_KEY']}"},
)
print(res.json())
```

**Response**

```json
{
  "deleted": true
}
```