GET /apiv2/billing/limits

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

Endpoint URL

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

अनुरोध Headers

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

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

उदाहरण

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

{
  "success": true,
  "data": {
    "limits": [
      {
        "id": 1,
        "scope": "account",
        "origin": "netts",
        "editable": false,
        "canDisable": false,
        "period": "outstanding",
        "productCode": null,
        "apiKeyId": null,
        "enabled": true,
        "revision": 3,
        "limit": { "unit": "USD", "value": "30000.000000" },
        "equivalent": { "unit": "TRX", "value": "90677.230000" },
        "used": { "unit": "USD", "value": "1250.400000" },
        "available": { "unit": "USD", "value": "28749.600000" },
        "creditApplied": { "unit": "USD", "value": "0" },
        "status": "ok",
        "periodStart": null,
        "periodEnd": null,
        "cappedBy": null
      },
      {
        "id": 5,
        "scope": "account",
        "origin": "client",
        "editable": true,
        "canDisable": true,
        "period": "day",
        "productCode": "energy_5m",
        "apiKeyId": null,
        "enabled": true,
        "revision": 1,
        "limit": { "unit": "USD", "value": "200.000000" },
        "equivalent": { "unit": "TRX", "value": "604.514867" },
        "used": { "unit": "USD", "value": "35.200000" },
        "available": { "unit": "USD", "value": "164.800000" },
        "creditApplied": null,
        "status": "ok",
        "periodStart": "2026-10-19T00:00:00+00:00",
        "periodEnd": "2026-10-20T00:00:00+00:00",
        "cappedBy": null
      }
    ],
    "products": {
      "energy_1h": { "unit": "USD", "spendable": "28749.600000", "limitingLimitIds": [1], "maxPerOrder": null, "status": "ok" },
      "energy_5m": { "unit": "USD", "spendable": "164.800000", "limitingLimitIds": [5], "maxPerOrder": null, "status": "ok" }
    },
    "unit": "USD",
    "asOf": "2026-10-19T20:24:26.525887+00:00",
    "checkedApiKeyId": 6,
    "valuationStatus": "ok",
    "creditUsdc": "0",
    "fx": { "usdPerTrx": "0.33084276", "at": "2026-10-19T20:24:23.449930+00:00" },
    "fxStatus": "ok"
  },
  "timestamp": "2026-10-19T20:24:26+00:00"
}

एक सीमा

Field	Description
id	सीमा संख्या — अपनी सीमा को बदलने, बंद या चालू करने के लिए इसका उपयोग करें
scope	account — पूरे खाते पर लागू होता है; key — एक API कुंजी (apiKeyId) पर लागू होता है
origin	netts — Netts द्वारा निर्धारित, केवल पढ़ने योग्य; client — आपकी अपनी सीमा
editable, canDisable	क्या आप इस सीमा को बदल सकते हैं या बंद कर सकते हैं
period	outstanding, day, week या order — देखें क्या गिना जाता है
productCode	वह उत्पाद जिस पर सीमा लागू होती है, समग्र सीमा के लिए null
enabled	false — सीमा बंद है और लागू नहीं होती है
revision	वर्तमान संस्करण; जब आप सीमा बदलते हैं तो इसे expectedRevision के रूप में भेजें
limit, equivalent	सीमा और, संदर्भ के लिए, वर्तमान दर पर दूसरी मुद्रा में इसका मूल्य
used, available	कितना उपयोग किया गया है और कितना शेष है; बंद की गई सीमा और order सीमाओं के लिए null
creditApplied	outstanding सीमा में गिने गए अधिक भुगतान से क्रेडिट
maxPerOrder	order सीमा के लिए: सबसे बड़ा एकल ऑर्डर
periodStart, periodEnd	day और week के लिए: वर्तमान UTC अवधि
cappedBy	आपकी सीमा Netts द्वारा कम किए जाने के बाद Netts की सीमा से अधिक है: Netts सीमा id जो इसके बजाय लागू होती है
status	ok, limit_reached, disabled, other_key (आपकी दूसरी कुंजियों में से एक की सीमा), या unavailable

उत्पाद

products प्रत्येक उत्पाद के लिए दिखाता है कि उस उत्पाद का अगला ऑर्डर कितना उपयोग कर सकता है: spendable लागू होने वाली सभी सीमाओं में सबसे छोटी शेष राशि है, और limitingLimitIds उन सीमाओं का नाम बताता है जो इसे निर्धारित करती हैं। यदि order सीमा लागू होती है तो maxPerOrder सबसे बड़ा एकल ऑर्डर है।

कुंजी सीमाएँ उस कुंजी के लिए गिनी जाती हैं जिसने यह अनुरोध किया था — checkedApiKeyId। यदि इस समय संख्याओं की गणना नहीं की जा सकती है, तो valuationStatus unavailable होता है: सीमाएँ अभी भी सूचीबद्ध होती हैं, used, available और spendable null होते हैं। उस स्थिति में उन्हें कभी भी शून्य या असीमित के रूप में नहीं दिखाया जाता है।

त्रुटियाँ

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

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