> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Suppressions

> List suppressed emails in your workspace.

Retrieve a paginated list of all currently suppressed email addresses via the Mailofly API.

### Query Parameters

**page** `number` (default: 1)

Page number.

**page\_size** `number` (default: 50)

Page size (max 100).

### Response

**data** `array`

**id** `string`

Suppression ID.

**email** `string`

Suppressed email.

**reason** `string`

Reason.

**created\_at** `string`

Created timestamp.

**pagination** `object`

**total** `number`

Total suppressed addresses.

**page** `number`

Page number.

**page\_size** `number`

Page limit.

```bash cURL theme={null}
curl -X GET "https://api.mailofly.com/suppressions?page=1&page_size=25" \
  -H "Authorization: Bearer mf_live_your_api_key"
```

```json 200 OK theme={null}
{
  "data": [
    {
      "id": "sup_123",
      "email": "baduser@example.com",
      "reason": "complaint",
      "created_at": "2026-09-11T14:00:00Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "page_size": 25
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.