وضعیت و رویدادهای یک ایمیل

وضعیت ارسال و خط زمانی رویدادها (ارسال، تحویل، بازگشت، شکایت).

GEThttps://api.irnoti.com/v1/email/outbound/{id}

scope: email.read

فیلد events شامل sent، delivered، bounced، complained یا failed همراه با گیرنده و توضیح سرور مقصد است. وضعیت‌ها: queued، sending، sent، delivered، bounced، failed، complained، canceled.

پارامترها

نام	محل	نوع	توضیح
id *	مسیر	string	شناسهٔ برگشتی از `POST /email/send`.

خطاهای خاص این endpoint

404	not_found	ایمیل پیدا نشد.
401	unauthorized	کلید API نامعتبر یا منقضی است.
403	feature_disabled	قابلیت ایمیل (یا دامنهٔ دسترسی لازم) برای کلید/حساب شما فعال نیست.

اجرای زنده (محیط تست)

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

→ قبلی

ارسال ایمیل

بعدی ←

فهرست ایمیل‌های ارسالی

curl -X GET 'https://api.irnoti.com/v1/email/outbound/5012' \
  -H "Authorization: Bearer $IRNOTI_KEY"

پاسخ نمونه200 OK

{
  "id": "5012",
  "events": [
    {
      "id": "1",
      "type": "sent",
      "detail": null,
      "createdAt": "2026-10-21T10:00:01.000Z",
      "recipient": null
    },
    {
      "id": "2",
      "type": "delivered",
      "detail": null,
      "createdAt": "2026-10-21T10:00:04.000Z",
      "recipient": "customer@gmail.com"
    }
  ],
  "source": "api",
  "status": "delivered",
  "subject": "سفارش شما ثبت شد",
  "toAddrs": [
    "customer@gmail.com"
  ],
  "fromAddr": "noreply@example.ir",
  "billedVia": "plan",
  "recipients": 1
}