Bounce report
Why your emails bounced over the last days: totals, the main kinds of bounce and the recipient domains that bounce most. The same numbers as Bounce report in the panel.
GET
/api/v1/partner/email/bounce-report
Connected apps need email.reports:read. See Connected apps (OAuth).
Query parameters
Response
json
{
"success": true,
"report": {
"sent": 18240,
"delivered": 17702,
"soft_bounces": 96,
"hard_bounces": 214,
"hard_bounce_rate": 1.17,
"complaints": 6,
"opens": 6120,
"clicks": 980,
"rejected": 22,
"by_category": [
{ "category": "User not found", "count": 171, "percentage": 55.2, "description": "Recipient mailbox doesn't exist. Remove these addresses from your list." },
{ "category": "Mailbox full", "count": 58, "percentage": 18.7, "description": "Recipient mailbox is over quota. Will likely accept mail later." }
],
"by_domain": [
{ "domain": "example.com", "count": 64, "percentage": 20.6 }
],
"window_days": 30
}
}by_category and by_domain are empty (or null) when nothing bounced.
For a file, GET /api/v1/partner/email/bounce-report.csv gives the same report as CSV (not open to connected apps).
cURL
bash
curl "https://api.splashifypro.com/api/v1/partner/email/bounce-report?days=7" \
-H "Authorization: Bearer $SPLASHIFY_API_KEY"