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

ارسال‌های شما با فیلتر وضعیت و جستجو؛ صفحه‌بندی با `before`.

GEThttps://api.irnoti.com/v1/email/outbound

scope: email.read

پاسخ {items, next} است؛ next را به‌عنوان before بفرستید. خروجی CSV: GET /email/outbound.csv.

پارامترها

نام	محل	نوع	توضیح
status	query	string	`queued\|sending\|sent\|delivered\|bounced\|failed\|complained\|canceled`
source	query	string	`panel\|api\|smtp\|system`
q	query	string	جستجو در موضوع و فرستنده.
before	query	string	شناسه برای صفحهٔ بعد.
limit	query	number	تا ۲۰۰ (پیش‌فرض ۵۰).

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

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

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

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

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

→ قبلی

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

بعدی ←

لغو ایمیل زمان‌بندی‌شده

curl -X GET 'https://api.irnoti.com/v1/email/outbound?limit=20&status=bounced' \
  -H "Authorization: Bearer $IRNOTI_KEY"

پاسخ نمونه200 OK

{
  "next": null,
  "items": [
    {
      "id": "5012",
      "cost": "0",
      "source": "api",
      "status": "delivered",
      "subject": "سفارش شما ثبت شد",
      "toAddrs": [
        "customer@gmail.com"
      ],
      "fromAddr": "noreply@example.ir",
      "billedVia": "plan",
      "recipients": 1
    }
  ]
}