/v1/workspaces/{workspace_id}/statsAuthMail stats for a workspace
Outbound sent, delivered, bounced, complained, deferred, suppressed and unconfirmed counts in the window, the deliverability, bounce and complaint rates, domain totals, the last send time and a daily sent series. For ranges, buckets, filters and a per-domain breakdown use `GET /emails/metrics`; the rates here use its definitions. `delivered` means the recipient's mail server confirmed the message; `unconfirmed` means the message was handed off and nothing came back either way, which is not the same as delivered. Days are UTC. Rates are 0 to 1, or null when not measured: delivery and complaints are only reported for mail with delivery tracking. Outbound messages are kept for 30 days, so 30d is the longest window. Cached for up to 60 seconds (`generated_at`).
Path parameters
workspace_id*string · uuidWorkspace id.
Query parameters
windowenum (3)Window for `in_window` and the length of `series`, in UTC days ending today. 30d is the maximum because outbound messages are kept for 30 days.
Response · 200 Mail stats.
window*objectWindow the counts cover.
Example: "30d"
generated_at*string · date-timeWhen these numbers were computed. Responses are cached for up to 60 seconds.
Example: "2026-10-07T09:00:00.000Z"
last_activity_at*string · date-timeMost recent outbound message `created_at` still on record (30-day retention). Null when none.
Example: "2026-10-07T08:41:12.000Z"
totals*objectAll-time counts.
in_window*objectOutbound counts in the window.
series*objectDaily sent messages.
Example
Request
GET https://api.mail.productcraft.co/v1/workspaces/{workspace_id}/stats
Authorization: Bearer YOUR_TOKENResponse
{
"window": "30d",
"generated_at": "2026-10-07T09:00:00.000Z",
"last_activity_at": "2026-10-07T08:41:12.000Z",
"totals": {},
"in_window": {},
"series": {}
}