فعال نسخه ۱.۰.۲

استعلام بدهی بانکی

این سرویس امکان استعلام آنی مجموع بدهی‌های معوق، جاری و مشکوک‌الوصول اشخاص حقیقی و حقوقی را از طریق شبکه بانکی کشور فراهم می‌کند. ایده‌آل برای سیستم‌های اعتبارسنجی و لندتک‌ها.

linkنقطه اتصال (Endpoint)

                            POST
                            https://api.api360.ir/v1/banking/debt
                        

هدرهای احراز هویت

کلید	مقدار	توضیحات
Authorization	Bearer {API_KEY}	کلید اختصاصی پنل کاربری

پارامترهای ورودی (Body)

پارامتر	نوع	الزامی	توضیحات
nationalCode	String	بله	کد ملی ۱۰ رقمی متقاضی
mobile	String	بله	شماره موبایل منطبق با کد ملی

تعرفه سرویس

محاسبه به ازای هر فراخوانی موفق

۱,۵۰۰ تومان

نمونه درخواست JSON

{
  "nationalCode": "0012345678",
  "mobile": "09123456789"
}

پاسخ موفق (200 OK)

{
  "success": true,
  "data": {
    "fullName": "رضا محمدی",
    "totalLoans": 3,
    "totalDebtAmount": 150000000,
    "overdueAmount": 12000000,
    "lastUpdate": "2023-10-15T14:30:00Z"
  }
}

خطاهای احتمالی

{
  "success": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "فرمت کد ملی یا موبایل اشتباه است"
  }
}