Access is invite-only during beta. Once invited, create a key to personalize these examples. Production sending requires a separate review.
Recipients
Look up one address: sends, suppressions, and firewall.
Look up one address on the token's team. Returns recent sends, suppressions, the firewall verdict, and whether the address can receive mail. A Support key masks runs of four or more digits in explanations. It never returns a raw event payload.
GET /api/v1/teams/:obfuscated_team_id/recipients
Look up a recipient by email.
email: Recipient address. Case-insensitive. Required for a useful result.
request.sh
1
curl -sS -X GET \
2
-H 'Authorization: Bearer YOUR_API_KEY' \
3
https://app.postshiba.com/api/v1/teams/KjkAJW/recipients
response.json
1
{
2
"email": "dest@example.com",
3
"can_receive": false,
4
"suppressions": [
5
{
6
"id": "YtReWq",
7
"email": "blocked@example.com",
8
"reason": "manual",
9
"tenant_id": "WbLcFd",
10
"tenant": "default",
11
"created_at": "2026-08-30T00:00:00Z"
12
}
13
],
14
"firewall": null,
15
"sends": [
16
{
17
"id": "JkLmNp",
18
"event_type": "dropped",
19
"message_id": null,
20
"occurred_at": "2026-08-29T00:00:00Z",
21
"explanation": "We did not send this message because the address is on your suppression list."
22
}
23
]
24
}