GET /apiv2/billing/account

आपका पोस्टपेड खाता एक नज़र में: Netts द्वारा निर्धारित क्रेडिट सीमा, आपकी अपनी समग्र सीमा, आप पर कितना बकाया है और अभी आप कितना खर्च कर सकते हैं। पोस्टपेड बिलिंग का हिस्सा।

Endpoint URL

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

अनुरोध Headers

Header	Required	Description
X-API-KEY	हाँ	billing.read अनुमति वाली API कुंजी
X-Real-IP	हाँ	कुंजी श्वेतसूची (whitelist) से एक पता

अनुरोध में कोई पैरामीटर नहीं हैं।

उदाहरण

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 फ़ील्ड

Field	Description
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	आप अपने अनुबंध के तहत चालानों (invoices) का भुगतान कैसे करते हैं: मुद्रा, नेटवर्क और चालान का भुगतान करने के दिन
limit, unpaid, creditUsdc, available	Netts सीमा, TRX में और आपके अनुबंध की मुद्रा में अवैतनिक राशि, आपका क्रेडिट, और Netts सीमा का शेष भाग
availableTrxEquiv, availableUsdEquiv	fx में दी गई दर पर परिवर्तित available; null जब कोई दर उपलब्ध न हो
fx	आपके अनुबंध की मुद्रा में TRX की वर्तमान दर और वह समय जब इसे लिया गया था। यह तुलना के लिए एक अनुमान है, किसी भविष्य के ऑर्डर की दर नहीं — देखें दर्ज विनिमय दर
fxStatus	ok, या unavailable — तब समकक्ष मान null होते हैं, राशियाँ फिर भी दिखाई जाती हैं

used और available की गणना उसी तरह की जाती है जैसे किसी ऑर्डर की जाँच की जाती है, इसलिए effectiveAvailable वह राशि है जिसे अगला ऑर्डर उपयोग कर सकता है। उत्पाद सीमाएँ सीमाओं में दिखाई गई हैं।

त्रुटि प्रतिक्रियाएं

HTTP	code	Meaning
401	-1, -2	कुंजी गायब है या अमान्य है, या IP श्वेतसूची में नहीं है — API गेटवे द्वारा उत्तर दिया गया, देखें प्रतिक्रिया प्रारूप
403	billing_read_required	कुंजी के पास billing.read की अनुमति नहीं है
403	postpaid_required	खाते में कोई पोस्टपेड बिलिंग नहीं है

सभी कोड पोस्टपेड बिलिंग में सूचीबद्ध हैं।