GET /apiv2/billing/account

آپ کا پوسٹ پیڈ اکاؤنٹ ایک نظر میں: Netts کی طرف سے مقرر کردہ کریڈٹ کی حد، آپ کی اپنی مجموعی حد، آپ کے ذمہ واجب الادا رقم اور اس وقت آپ مزید کتنی رقم خرچ کر سکتے ہیں۔ پوسٹ پیڈ بلنگ کا حصہ۔

اینڈ پوائنٹ URL

GET https://netts.io/apiv2/billing/account

درخواست کے ہیڈرز

Header	مطلوب ہے	تفصیل
X-API-KEY	ہاں	billing.read اجازت کے ساتھ API کلید
X-Real-IP	ہاں	کلید کی وائٹ لسٹ سے ایک پتہ

درخواست میں کوئی پیرامیٹر نہیں ہے۔

Example

curl -s 'https://netts.io/apiv2/billing/account' \
  -H 'X-API-KEY: your-api-key' \
  -H 'X-Real-IP: 203.0.113.10'

{
  "success": true,
  "data": {
    "mode": "postpaid",
    "adminLimit": {
      "id": 1,
      "origin": "netts",
      "limit": { "unit": "USD", "value": "30000.000000" },
      "used": { "unit": "USD", "value": "1250.400000" },
      "available": { "unit": "USD", "value": "28749.600000" },
      "creditApplied": { "unit": "USD", "value": "0" },
      "status": "ok",
      "revision": 3,
      "editable": false
    },
    "clientLimit": {
      "id": 4,
      "origin": "client",
      "limit": { "unit": "USD", "value": "5000.000000" },
      "used": { "unit": "USD", "value": "1250.400000" },
      "available": { "unit": "USD", "value": "3749.600000" },
      "creditApplied": { "unit": "USD", "value": "0" },
      "status": "ok",
      "revision": 2,
      "editable": true
    },
    "effectiveAvailable": { "unit": "USD", "value": "3749.600000" },
    "pendingUnbilled": { "trx": "0", "count": 0 },
    "asOf": "2026-10-19T20:24:26.474237+00:00",
    "settlement": { "asset": "USDC", "network": "ethereum", "paymentTermsDays": 5 },
    "limit": { "unit": "USD", "value": "30000.000000" },
    "unpaid": { "TRX": "3778.500000", "USDC": "1250.400000" },
    "creditUsdc": "0",
    "available": "28749.600000",
    "availableTrxEquiv": "86897.437285",
    "availableUsdEquiv": "28749.600000",
    "fx": { "usdPerTrx": "0.33084276", "at": "2026-10-19T20:24:23.449930+00:00" },
    "fxStatus": "ok"
  },
  "timestamp": "2026-10-19T20:24:26+00:00"
}

Response فیلڈز

فیلڈ	تفصیل
mode	postpaid، یا prepaid جب اکاؤنٹ کی پوسٹ پیڈ بلنگ معطل ہو
adminLimit	Netts کی طرف سے مقرر کردہ کریڈٹ کی حد۔ editable ہمیشہ false ہوتا ہے
clientLimit	آپ کی اپنی مجموعی حد، یا null اگر آپ نے کوئی حد مقرر نہیں کی ہے
adminLimit.used / clientLimit.used	حد میں سے کتنی رقم استعمال ہو چکی ہے
adminLimit.available / clientLimit.available	حد میں سے کتنی رقم باقی ہے
creditApplied	اضافی ادائیگیوں سے آپ کا کریڈٹ جو پہلے ہی اس حد میں قرض کو کم کرتا ہے
status	ok، limit_reached، یا unavailable اگر اس وقت اس کا حساب نہیں لگایا جا سکتا
effectiveAvailable	جو رقم آپ اب خرچ کر سکتے ہیں: دونوں available اقدار میں سے کم والی
pendingUnbilled	پہلے سے قبول شدہ آرڈرز جن کے چارجز ابھی ریکارڈ ہو رہے ہیں: ان کی کل TRX رقم اور تعداد
asOf	وہ لمحہ جب اعداد و شمار کا حساب لگایا گیا تھا
settlement	آپ اپنے معاہدے کے تحت انوائسز کیسے ادا کرتے ہیں: کرنسی، نیٹ ورک اور انوائس ادا کرنے کے دن
limit، unpaid، creditUsdc، available	Netts کی حد، TRX میں اور آپ کے معاہدے کی کرنسی میں غیر ادا شدہ رقم، آپ کا کریڈٹ، اور Netts کی حد میں سے کیا باقی ہے
availableTrxEquiv، availableUsdEquiv	fx میں دی گئی شرح پر تبدیل شدہ available؛ null جب کوئی شرح دستیاب نہ ہو
fx	آپ کے معاہدے کی کرنسی کے مقابلے میں TRX کی موجودہ شرح اور وہ لمحہ جب یہ لی گئی تھی۔ یہ موازنہ کے لیے ایک تخمینہ ہے، کسی مستقبل کے آرڈر کی شرح نہیں — دیکھیں ریکارڈ شدہ شرح مبادلہ
fxStatus	ok، یا unavailable — ایسی صورت میں مساوی اقدار null ہوتی ہیں، رقوم پھر بھی دکھائی جاتی ہیں

used اور available کا حساب اسی طرح لگایا جاتا ہے جیسے کسی آرڈر کی تصدیق کی جاتی ہے، لہٰذا effectiveAvailable وہ رقم ہے جو اگلا آرڈر استعمال کر سکتا ہے۔ پروڈکٹ کی حدود حدود میں دکھائی گئی ہیں۔

خرابی کے جوابات

HTTP	code	مفہوم
401	-1، -2	کلید غائب یا غلط ہے، یا IP وائٹ لسٹ میں شامل نہیں ہے — API گیٹ وے کے ذریعے جواب دیا گیا، دیکھیں جواب کا فارمیٹ
403	billing_read_required	کلید کے پاس billing.read کی اجازت نہیں ہے
403	postpaid_required	اکاؤنٹ میں پوسٹ پیڈ بلنگ فعال نہیں ہے

تمام کوڈز پوسٹ پیڈ بلنگ میں درج ہیں۔