Analytics API
The same figures the dashboard shows: how much you have sent, how much arrived, and how close you are to your monthly quota. Useful for a status panel of your own, a weekly report, or an alert when a bounce rate moves in the wrong direction. For the individual events behind these totals, use the Logs API.
Scope
#Needs email:read. Figures are scoped to the key's team.
/v1/analyticsTotals, rates, a 30 day daily series and current usage against your plan.
Parameters
| Parameter | Type | Description |
|---|---|---|
| days | number | Add a window block covering the last N days. 1 to 90. Defaults to 30 when a window is requested. |
| domain | string | Restrict the window block to one verified sending domain. Returns 404 if the domain is not yours. |
Response
{
"total": 24707,
"sent": 24190,
"today": 312,
"thisWeek": 2190,
"delivered": 23610,
"bounced": 402,
"complained": 11,
"failed": 157,
"pending": 320,
"canceled": 40,
"awaitingReport": 167,
"deliveryRate": 98.3,
"bounceRate": 0.6,
"bounces": {
"days": 30,
"from": "2026-10-10T09:30:00.000Z",
"reported": 10840,
"hard": 65,
"soft": 212,
"hardRate": 0.6,
"softRate": 2.0
},
"daily": [
{ "date": "2026-08-22", "sent": 780, "delivered": 761, "bounced": 12 }
],
"usage": {
"period": "2026-09",
"sent": 8420,
"delivered": 8201,
"bounced": 140,
"limit": 100000,
"tier": "growth"
}
}Scoping to a window or a domain
#Without parameters the response covers all time, plus a fixed 30 day daily series and the bounce rate, which is always over the last 30 days (see below). Passing days or domain adds a window block alongside the all-time numbers rather than replacing them.
# all time, plus a 30 day daily series and the 30 day bounce rate
curl https://smtpfa.st/api/v1/analytics \
-H "Authorization: Bearer $SMTPFAST_API_KEY"
# add a scoped window: the last 7 days for one sending domain
curl "https://smtpfa.st/api/v1/analytics?days=7&domain=acme.com" \
-H "Authorization: Bearer $SMTPFAST_API_KEY"Reading the rates
#delivered counts mail the receiving server accepted, which includes messages later opened or clicked. A complained email was delivered too, so deliveryRate counts it as delivered. bounceRate is the one to watch: mailbox providers start treating a sender differently well before it reaches a few percent, so a rising trend matters more than any single day.
Opens are less exact than they look. Gmail and Apple Mail load images through a proxy, often seconds after delivery, so an email can count as opened before anyone reads it. Use the open rate as a trend, and clicks as the stronger signal.
This endpoint is older than the snake_case convention and keeps its camelCase field names (deliveryRate, thisWeek) so existing integrations do not break. GET /v1/emails/metrics below uses snake_case.
Rates are worked out against the emails that went out and have a delivery or bounce report: sent minus awaitingReport. Right after a large send many emails are still waiting for that report, and counting them would pull the delivery rate down for a while. Scheduled and queued emails are counted in pending and stay out of the rates until they send, so scheduling a broadcast never moves them. today, thisWeek and the daily series count by the time an email was sent, over the last 24 hours, the last 7 days and the last 30 days. total counts every email, whatever its status.
Hard and soft bounces
#Amazon SES reports every bounce as permanent, transient or undetermined. A hard bounce (permanent) means the address does not exist or does not take mail. A soft bounce (transient) is a temporary failure, such as a full mailbox, and the same address may take mail later. SES works out the bounce rate it reviews an account on from hard bounces only, and so does SMTPfast.
bounceRateis hard bounces only, over the emails sent in the last 30 days that have a delivery or bounce report. Thebouncesobject holds the numbers behind it:hard,soft,reported(the denominator), both rates, and the window (daysandfrom).- An undetermined bounce counts as hard. When SES cannot tell, we assume the worse, so the rate never reads lower than it is.
- Soft bounces are shown for information and are not part of any bounce rate. A broadcast where a large share of recipients soft bounce is still paused, because that usually means an old list.
- A past bounce stays counted, even if the address was later unsubscribed or suppressed. The 30 day window is what lets the rate recover after you clean a list.
bouncedandusage.bouncedstill count every bounce, hard or soft. Thewindowblock reportshard_bouncedandsoft_bouncedby the same rule.
Email metrics
#GET /v1/emails/metrics takes the same parameters and returns the same shape as Resend's Email Metrics API. It counts transactional and broadcast email together, and each lifecycle timestamp counts in its own period. Rates are percentages with one decimal.
/v1/emails/metricsCounts and rates over a date range, optionally broken down.
Parameters
| Parameter | Type | Description |
|---|---|---|
| start_date | string | ISO 8601 date or datetime; default 6 days before end_date |
| end_date | string | ISO 8601 date (whole day included) or datetime; default now |
| timezone | string | IANA time zone for dates and periods, default UTC |
| granularity | string | hourly, daily, weekly or monthly (with the period dimension) |
| metrics | string | Comma-separated, e.g. sent,delivered,open_rate; default all |
| dimensions | string | Comma-separated: period, domain, email, broadcast |
| domain_id | string | Comma-separated ids, up to 100 |
| email_id | string | Comma-separated ids, up to 100 |
| broadcast_id | string | Comma-separated ids, up to 100 |
| include | string | providers adds the breakdown by mailbox provider, below |
Response
{
"object": "metrics",
"start_date": "2026-07-01T00:00:00.000Z",
"end_date": "2026-07-08T00:00:00.000Z",
"timezone": "UTC",
"metrics": ["sent", "delivered", "open_rate"],
"dimensions": ["period"],
"granularity": "daily",
"totals": { "sent": 1204, "delivered": 1180, "open_rate": 50.0 },
"data": [ { "period": "2026-07-01", "sent": 172, "delivered": 169, "open_rate": 49.7 } ]
}By mailbox provider
Add include=providers and the response gets a providers array: sent email split by the recipient's mailbox provider (Gmail, Outlook, iCloud, Yahoo, Proton and Other), with each one's share of sent and its delivery, open, bounce and complaint rates. It shows when one provider treats your mail differently, for example Outlook bouncing mail that Gmail accepts. The Metrics page and each broadcast's page show the same table. Providers with nothing sent are left out, and the rest come most sent first.
{
"object": "metrics",
"start_date": "2026-10-01T00:00:00.000Z",
"end_date": "2026-10-22T09:30:00.000Z",
"totals": { "sent": 1204, "delivered": 1180, "open_rate": 50.0 },
"providers": [
{
"provider": "gmail",
"name": "Gmail",
"sent": 812,
"share": 67.44,
"delivered": 798,
"bounced": 9,
"hard_bounced": 4,
"soft_bounced": 5,
"complained": 1,
"tracked_delivered": 790,
"opened": 402,
"delivery_rate": 98.88,
"open_rate": 50.89,
"bounce_rate": 0.5,
"soft_bounce_rate": 0.62,
"complaint_rate": 0.13
},
{
"provider": "outlook",
"name": "Outlook",
"sent": 241,
"share": 20.02,
"delivered": 219,
"bounced": 21,
"hard_bounced": 17,
"soft_bounced": 4,
"complained": 0,
"tracked_delivered": 219,
"opened": 88,
"delivery_rate": 91.25,
"open_rate": 40.18,
"bounce_rate": 7.08,
"soft_bounce_rate": 1.67,
"complaint_rate": 0
},
{
"provider": "icloud",
"name": "iCloud",
"sent": 151,
"share": 12.54,
"delivered": 150,
"bounced": 1,
"hard_bounced": 1,
"soft_bounced": 0,
"complained": 0,
"tracked_delivered": 150,
"opened": 121,
"delivery_rate": 99.34,
"open_rate": 80.67,
"bounce_rate": 0.66,
"soft_bounce_rate": 0,
"complaint_rate": 0
}
]
}- Each email counts once, under the domain of its first To address. Cc and Bcc recipients are not counted on their own; a broadcast email has one recipient. The breakdown covers the emails created in the range that match domain_id, email_id or broadcast_id, with their status now, so it is not the totals split up: the totals count each lifecycle timestamp in its own period. Sends only to the SES mailbox simulator are left out here too.
- gmail.com and googlemail.com are Gmail; outlook.com, hotmail.*, live.* and msn.com are Outlook; icloud.com, me.com and mac.com are iCloud; yahoo.*, ymail.com and aol.com are Yahoo; proton.me, protonmail.com, protonmail.ch and pm.me are Proton. Any other domain is classified by its MX records, so a company on Google Workspace counts as Gmail and one on Microsoft 365 as Outlook. MX answers are cached for 7 days. One request looks up at most 50 new domains, busiest first; a domain not looked up yet counts as Other until a later request classifies it.
delivery_rateandbounce_rateare over the emails with a delivery or bounce report (delivered plus bounced), so mail still waiting for its report does not pull them down.bounce_ratecountshard_bouncedonly;soft_bouncedhas its ownsoft_bounce_rate. A complaint comes from the inbox, so a complained email counts as delivered.complaint_rateis complaints over delivered.open_rateis opened overtracked_delivered, the delivered emails that went out with the open pixel, so email sent with tracking off does not count as unopened. Email sent before 22 October 2026 has no record of that choice and counts as tracked.- iCloud open rates read high. Apple Mail Privacy Protection loads remote images, the open pixel included, when a message arrives, whether or not anyone reads it. Compare iCloud by clicks, or by its bounce and complaint rates.
- Rates are percentages with two decimals, and null when there is nothing to rate yet.
Clicked links
#The links people clicked across all email, the same data as the Links page. Resend lists clicked links per broadcast only; this covers every email.
/v1/emails/clicked-linksTop clicked links, or one link in detail with url.
Parameters
| Parameter | Type | Description |
|---|---|---|
| days | integer | 1 to 365, default 30 |
| domain_id | string | Only email sent from this domain |
| url | string | One exact destination URL for detail |
Response
{
"object": "list",
"days": 30,
"total_clicks": 412,
"unique_clicks": 268,
"distinct_links": 9,
"truncated": false,
"data": [ { "url": "https://example.com/pricing", "clicks": 120, "unique_clicks": 88 } ]
}