GET /apiv2/billing/invoices

आपके पोस्टपेड इनवॉइस। आपके अनुबंध में निर्धारित बिलिंग अवधि के अंत में उस अवधि की सेवाओं के लिए एक इनवॉइस जारी किया जाता है; प्रत्येक इनवॉइस की एक नियत तिथि (due date) होती है। पोस्टपेड बिलिंग का हिस्सा।

एंडपॉइंट्स

एंडपॉइंट	रिटर्न करता है
GET /apiv2/billing/invoices	सभी इनवॉइस, सबसे नई अवधि पहले
GET /apiv2/billing/invoices/{id}	एक इनवॉइस उसके शुल्कों के साथ

अनुरोध हेडर

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

उदाहरण

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

{
  "success": true,
  "data": {
    "id": 12,
    "periodStart": "2026-10-12T00:00:00+00:00",
    "periodEnd": "2026-10-19T00:00:00+00:00",
    "totalTrx": "3778.500000",
    "totalUsdc": "1250.400000",
    "paidUsdc": "0.000000",
    "status": "issued",
    "issuedAt": "2026-10-19T00:10:00+00:00",
    "dueAt": "2026-10-24T00:10:00+00:00",
    "charges": [
      {
        "id": 1024,
        "orderId": "AB2EF201B582AA1",
        "productCode": "energy_1h",
        "amountTrx": "1.300000",
        "amountUsdc": "0.430096",
        "status": "invoiced"
      }
    ]
  },
  "timestamp": "2026-10-19T20:31:10+00:00"
}

प्रत्येक शुल्क में वही फ़ील्ड होते हैं जो उपयोग में हैं; उदाहरण उनमें से कुछ को दिखाता है।

एक इनवॉइस

फ़ील्ड	विवरण
id	इनवॉइस संख्या
periodStart, periodEnd	वह बिलिंग अवधि जिसे इनवॉइस कवर करता है, UTC
totalTrx, totalUsdc	इनवॉइस का कुल योग, TRX में और आपके अनुबंध की मुद्रा में
paidUsdc	पहले से कितना भुगतान किया जा चुका है, आपके अनुबंध की मुद्रा में
status	issued, delivered, partially_paid, paid या void
issuedAt	इनवॉइस कब जारी किया गया था
dueAt	भुगतान करने की अंतिम तिथि
charges	केवल /invoices/{id} में: इनवॉइस के शुल्क

सूची एंडपॉइंट charges के बिना समान फ़ील्ड लौटाता है। जिस खाते में अभी तक कोई इनवॉइस नहीं है, उसे एक खाली सूची मिलती है।

त्रुटियाँ

HTTP	code	अर्थ
401	-1, -2	कुंजी गायब है या अमान्य है, या IP श्वेतसूचीबद्ध नहीं है — API गेटवे द्वारा उत्तर दिया गया, देखें प्रतिक्रिया प्रारूप
403	billing_read_required, postpaid_required	कोई अनुमति नहीं है, या कोई पोस्टपेड बिलिंग नहीं है
404	not_found	आपके खाते पर ऐसा कोई इनवॉइस नहीं है