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
1curl -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}