Metrics

GET /v1/email/metrics answers the application’s figures, with a live key that reads Email (email:read). They come from the daily rollup Tawked keeps for good, so they reach back beyond the 30 days messages are kept. Test messages never count.

curl "https://tawked.com/v1/email/metrics?from=2026-10-01&to=2026-10-20&granularity=day" \
  -H "Authorization: Bearer $TAWKED_KEY"

Parameter	Meaning
`from`, `to`	Riyadh days, `YYYY-MM-DD`; the last 30 days ending today by default, at most 366 days apart.
`granularity`	`day` (the default), `week` (weeks start on Sunday) or `month`.
`domain`	One domain of the application, by id or name.
`timezone`	Only `Asia/Riyadh`.

{
  "from": "2026-10-01",
  "to": "2026-10-20",
  "timezone": "Asia/Riyadh",
  "granularity": "day",
  "domain": null,
  "totals": {
    "sent": 1200,
    "delivered": 1180,
    "delivery_delayed": 3,
    "bounced": 12,
    "bounced_permanent": 9,
    "bounced_transient": 3,
    "complained": 1,
    "failed": 2,
    "suppressed": 4,
    "opened": 800,
    "unique_opened": 510,
    "clicked": 120,
    "unique_clicked": 90,
    "open_tracked_targets": 1100,
    "click_tracked_targets": 1100
  },
  "rates": {
    "delivery_rate": 0.9833,
    "bounce_rate": 0.01,
    "complaint_rate": 0.0008,
    "open_rate": 0.4636,
    "click_rate": 0.0818
  },
  "data": [
    {
      "period": "2026-10-01",
      "sent": 60,
      "delivered": 59,
      "delivery_delayed": 0,
      "bounced": 1,
      "bounced_permanent": 1,
      "bounced_transient": 0,
      "complained": 0,
      "failed": 0,
      "suppressed": 0,
      "opened": 40,
      "unique_opened": 26,
      "clicked": 6,
      "unique_clicked": 5,
      "open_tracked_targets": 55,
      "click_tracked_targets": 55
    }
  ]
}

Every period of the range is present, zeros included; today is included, refreshed every five minutes.
The delivery counts are e-mails (each recipient counts), and delivery_rate, bounce_rate and complaint_rate are over sent, with four decimals, null when nothing was sent.
Opens and clicks are counted in targets, in both terms of the rate: a message sent to several people in one call counts as one target, since one pixel serves them all. unique_opened counts targets whose first open fell in the period, over open_tracked_targets, the delivered targets of messages sent with open tracking. opened and clicked count every event. See tracking.

Get started

Verify

Notifications

Email

Webhooks and errors

Partners

Build with AI