Runs examples for real against your account. Test keys only; kept in this tab, never stored on our side. Get a key
ZapSMTP / Docs / Statistics

Time series

GET/v1/stats/timeseries

Event counts by status in time buckets.

Requires a full-access key.

One point per (bucket, status); empty buckets are not emitted. Test-mode traffic excluded.

Query parameters

hoursinteger
1-720; out-of-range falls back to 24. Bucket size: <=1h → 60 s, <=6h → 300 s, <=24h → 1800 s, <=168h → 10800 s, otherwise 43200 s. Default 24.

Errors

restricted_api_keyHTTP 403
GET/v1/stats/timeseries
curl 'https://zapsmtp.xyz/v1/stats/timeseries?hours=24' \
  -H "Authorization: Bearer $ZAP_API_KEY"
Set ZAP_API_KEY in your environment.
Response 200 OK
{
  "hours": 24,
  "bucket_seconds": 1800,
  "since": "2026-10-20T15:00:00Z",
  "data": [
    {
      "t": "2026-10-20T15:00:00Z",
      "status": "delivered",
      "count": 74
    },
    {
      "t": "2026-10-20T15:00:00Z",
      "status": "queued",
      "count": 75
    }
  ]
}