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

const res = await fetch("https://tawked.com/v1/email/metrics?from=2026-10-01&to=2026-10-20&granularity=day", {
  headers: {
    Authorization: "Bearer tk_live_xxxxxxxxxxxxxxxxxxxx",
  },
});
const data = await res.json();

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://tawked.com/v1/email/metrics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import requests

res = requests.get(
    "https://tawked.com/v1/email/metrics?from=2026-10-01&to=2026-10-20&granularity=day",
    headers={"Authorization": "Bearer tk_live_xxxxxxxxxxxxxxxxxxxx"},
)
data = res.json()

{
  "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
    }
  ]
}

{
  "error": "invalid_request",
  "message": "The range is at most 366 days",
  "field": "from"
}

{
  "error": "unauthorized"
}

{
  "error": "live_key_required"
}

{
  "error": "not_found"
}

{
  "error": "email_access_required"
}

{
  "error": "too_many_requests"
}

{
  "error": "internal_error"
}