curl https://tawked.com/v1/email/received/0199f3a1-5c2e-7d40-9a1b-2c3d4e5f6a7b \
  -H "Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxx"

const res = await fetch("https://tawked.com/v1/email/received/0199f3a1-5c2e-7d40-9a1b-2c3d4e5f6a7b", {
  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/received/{id}",
  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/received/0199f3a1-5c2e-7d40-9a1b-2c3d4e5f6a7b",
    headers={"Authorization": "Bearer tk_live_xxxxxxxxxxxxxxxxxxxx"},
)
data = res.json()

{
  "id": "0199f3a1-5c2e-7d40-9a1b-2c3d4e5f6a7b",
  "address": {
    "id": "0199f2b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
    "domain": "inbound.acme.sa",
    "kind": "domain"
  },
  "to": [
    "orders@inbound.acme.sa"
  ],
  "from": {
    "name": "سارة",
    "address": "sara@example.com"
  },
  "subject": "استفسار عن الطلب 1042",
  "spam": false,
  "has_attachments": true,
  "attachments_count": 1,
  "size": 48211,
  "status": "ready",
  "thread": {
    "email_id": "0199f1c2-7a41-7c3e-9d2b-5e8f1a2b3c4d",
    "received_id": null
  },
  "received_at": "2026-10-26T09:12:03+00:00",
  "envelope_from": "bounce-123@mail.example.com",
  "header_to": [
    {
      "name": null,
      "address": "orders@inbound.acme.sa"
    }
  ],
  "cc": [],
  "reply_to": [],
  "message_id": "<CAF=abc@mail.example.com>",
  "in_reply_to": "<0102019a1b2c3d4e-5f6a7b8c@mail.acme.sa>",
  "references": [
    "<0102019a1b2c3d4e-5f6a7b8c@mail.acme.sa>"
  ],
  "reply_headers": {
    "In-Reply-To": "<CAF=abc@mail.example.com>",
    "References": "<0102019a1b2c3d4e-5f6a7b8c@mail.acme.sa> <CAF=abc@mail.example.com>"
  },
  "date": "2026-10-26T09:12:00+00:00",
  "text": "مرحبًا، متى يصل الطلب 1042؟\nشكرًا",
  "html": "<p>مرحبًا، متى يصل الطلب 1042؟</p><p>شكرًا</p>",
  "text_truncated": false,
  "html_truncated": false,
  "headers": [
    {
      "name": "From",
      "value": "سارة <sara@example.com>"
    },
    {
      "name": "Subject",
      "value": "استفسار عن الطلب 1042"
    }
  ],
  "attachments": [
    {
      "id": "0199f3a2-0b1c-7d2e-8f3a-4b5c6d7e8f90",
      "filename": "فاتورة.pdf",
      "content_type": "application/pdf",
      "content_id": null,
      "inline": false,
      "size": 20311,
      "risky": false,
      "download_url": "https://tawked.com/email-files/eyJpdiI6Ii4uLiJ9?expires=1792577523&signature=3f1c",
      "download_expires_at": "2026-10-26T10:12:03+00:00"
    }
  ],
  "attachments_skipped": 0,
  "raw": {
    "download_url": "https://tawked.com/email-files/eyJpdiI6Ii0tLSJ9?expires=1792577523&signature=9a2b",
    "expires_at": "2026-10-26T10:12:03+00:00"
  },
  "authentication": {
    "spf": "pass",
    "dkim": "pass",
    "dmarc": "pass",
    "dmarc_policy": null
  },
  "virus": "pass",
  "spam_verdict": "pass",
  "parse_error": null,
  "forwarded": null,
  "price_halalas": 0,
  "billing": "free",
  "expires_at": "2026-11-25T09:12:03+00:00"
}

{
  "error": "service_required"
}

{
  "error": "unauthorized"
}

{
  "error": "live_key_required"
}

{
  "error": "not_found"
}

{
  "error": "too_many_requests"
}

{
  "error": "internal_error"
}