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

پیام‌های ارسالی اخیر با وضعیت تحویل.

GET/sms/messages
scope: sms.read

جدیدترین‌ها اول. برای صفحه‌بندی از before (شناسه آخرین پیام صفحه قبل) استفاده کنید. وضعیت‌ها: queued، sent، delivered، failed.

پارامترها

ناممحلنوعتوضیح
takequeryintegerتعداد (پیش‌فرض ۵۰، حداکثر ۲۰۰).
beforequerystringفقط پیام‌های با شناسه کوچک‌تر.

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

با یک کلید آزمایشی (در پنل ← وب‌سرویس ← «کلید آزمایشی») این درخواست را همین‌جا اجرا کنید. پیام واقعی ارسال نمی‌شود و هزینه‌ای کسر نمی‌شود.

curl -X GET '/sms/messages?take=2' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
[
  {
    "id": "5521",
    "kind": "normal",
    "to": "09121234567",
    "body": "سلام",
    "parts": 1,
    "totalPrice": "980",
    "status": "delivered",
    "error": null,
    "sandbox": false,
    "createdAt": "2026-10-07T10:20:00.000Z",
    "sentAt": "2026-10-07T10:20:01.000Z",
    "deliveredAt": "2026-10-07T10:20:03.000Z"
  }
]
فهرست پیام‌ها — مستندات API | ایران ناتیفیکیشن