Retrieve metrics
GET/v1/metrics
Recipient outcomes per day for the project: sent, delivered, bounced, complained, failed and suppressed, with totals and rates, plus unique opens and clicks when tracking is on (measured against delivered). sent counts recipients the provider accepted. Days are in UTC. The default range is the last 30 days, and the longest is 92.
Required scope: emails:read
Parameters
| Name | In | Description |
|---|---|---|
fromoptional | query | First day, YYYY-MM-DD. |
tooptional | query | Last day, YYYY-MM-DD. Default today. |
Example
curl -X GET 'https://api.sendsend.email/v1/metrics' \
-H "Authorization: Bearer $SENDSEND_API_KEY"Response 200
{
"environment": "live",
"from": "2026-09-07",
"to": "2026-10-06",
"totals": {
"sent": 1240,
"delivered": 1198,
"bounced": 18,
"complained": 1,
"failed": 2,
"suppressed": 6,
"opened": 540,
"clicked": 120
},
"rates": {
"delivered": 0.966,
"bounced": 0.0145,
"complained": 0.0008,
"opened": 0.451,
"clicked": 0.1
},
"daily": [
{
"day": "2026-10-06",
"sent": 87,
"delivered": 84,
"bounced": 1,
"complained": 0,
"failed": 0,
"suppressed": 0,
"opened": 40,
"clicked": 9
}
]
}Errors
| Status | Code | When |
|---|---|---|
| 400 | validation_error | The request body or parameters are invalid. The message says which field. |
| 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.