Get domain insights
GET/v1/domains/{id}/insights
How a domain is doing over the last 1 to 90 days (default 30): delivery, bounce and complaint rates against the limits that pause sending, open and click rates when tracking is on, the state of its DNS setup, and a short list of what to do next. Only live mail counts. This reports what receiving servers told us; it cannot show inbox versus spam placement.
Required scope: domains:manage
Parameters
| Name | In | Description |
|---|---|---|
idrequired | path | The domain id. |
daysoptional | query | Window in days, 1 to 90. Default 30. |
Example
curl -X GET 'https://api.sendsend.email/v1/domains/ID/insights' \
-H "Authorization: Bearer $SENDSEND_API_KEY"Response 200
{
"object": "domain_insights",
"domain": "mail.acme.com",
"window_days": 30,
"status": "watch",
"totals": {
"messages": 480,
"sent": 500,
"delivered": 487,
"bounced": 11,
"complained": 0,
"failed": 0,
"suppressed": 3,
"opened": 0,
"clicked": 0
},
"rates": {
"delivered": 0.974,
"bounced": 0.022,
"complained": 0,
"opened": null,
"clicked": null
},
"setup": {
"dkim": "verified",
"spf_return_path": "aligned",
"dmarc": "monitoring",
"tracking": {
"opens": false,
"clicks": false
}
},
"recommendations": [
{
"level": "warning",
"code": "bounce_rate_high",
"title": "Bounce rate 2.2% is high",
"detail": "Aim to stay under 2.0%. Check for typos at sign-up, old addresses, or a purchased list."
}
]
}Errors
| Status | Code | When |
|---|---|---|
| 400 | validation_error | The request body or parameters are invalid. The message says which field. |
| 404 | not_found | No such resource in this project. |
| 401 | unauthorized | The API key is missing, invalid or revoked. |
| 403 | forbidden | The key does not have the scope this endpoint needs. |
Every error has the same shape. See Errors.