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 before showing anything about it.

Request

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

Response

{
    "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
`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`

List blocked senders

Request

Response

Errors