ایران ناتیفیکیشن

فهرست بانک‌های شماره

بانک‌های شمارهٔ در دسترس برای ارسال هدفمند به مخاطبان خارج از دفترچهٔ شما.

GEThttps://api.irnoti.com/v1/number-banks
scope: sms.read

هر بانک: نام، دسته، توضیح، برچسب‌ها، تعداد شمارهٔ فعال و کارمزد هر شماره (ریال). شماره‌ها به شما نمایش داده نمی‌شود؛ فقط می‌توانید با فیلتر برای تعداد مشخصی از آن‌ها ارسال کنید.

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

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.

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

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

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

curl -X GET 'https://api.irnoti.com/v1/number-banks' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
[
  {
    "id": "3",
    "name": "مشتریان تهران",
    "tags": [
      "تهران"
    ],
    "category": "فروشگاه",
    "available": 48210,
    "description": null,
    "feePerNumber": "20"
  }
]
فهرست بانک‌های شماره — مستندات API | ایران ناتیفیکیشن