:::endpoint GET /v1/me/mail/blocked-senders

Mail from a blocked sender is refused while it is being delivered, with a
`550` to the sending server. Nothing is stored and nobody here sees it. The
list is the whole environment's: a block made by one person holds for every
mailbox.

Every call about blocked senders takes the `manage_mailbox` permission as
well as the scope, because a block decides what the whole propfirm receives.
Check `permissions` in [your profile](/docs/api/apps/profile) before showing
anything about it.

## Request

```bash
curl https://api.proppertrading.com/v1/me/mail/blocked-senders \
  -H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f"
```

## Response

```json
{
    "data": [
        {
    "id": "blk_5ws77sgyjhhkqb66",
    "object": "mail_blocked_sender",
    "kind": "domain",
    "pattern": "amexp.com",
    "author": "Mick Schmidt",
    "created_at": "2026-09-25T10:14:02.000000Z",
    "hits": 3,
    "last_hit_at": "2026-09-25T16:40:51.000000Z"
}
    ],
    "meta": {
        "request_id": "req_01kz4bkr1aj1gv63d8fv3133ey",
        "has_more": false,
        "next_cursor": null
    }
}
```

Newest first, and never paged: a list of blocks stays short.

| Field         | Description                                                                          |
| ------------- | ------------------------------------------------------------------------------------ |
| `id`          | The entry, such as `blk_5ws77sgyjhhkqb66`. Use it to [lift the block](/docs/api/mail/blocked-sender-delete) |
| `kind`        | `address` for one address, `domain` for a domain and every subdomain under it       |
| `pattern`     | The address or the domain, lowercase                                                   |
| `author`      | Who blocked it, or null when that account is gone                                      |
| `hits`        | How often mail was refused because of it                                              |
| `last_hit_at` | When it last refused something, or null if it never has. Worth a look before lifting |

## Errors

| Status | Code                 | Meaning                                              |
| ------ | -------------------- | ---------------------------------------------------- |
| 403    | `insufficient_scope` | This device does not hold `mail:read`                |
| 403    | `forbidden`          | The account does not hold `manage_mailbox`           |