GET /apiv2/billing/limits

Setiap batas pada akun pascabayar Anda — batas kredit yang ditetapkan oleh Netts dan batas Anda sendiri — beserta berapa banyak dari masing-masing yang telah digunakan dan tersisa, serta berapa banyak yang masih dapat dibelanjakan oleh setiap produk. Bagian dari penagihan pascabayar.

URL Endpoint

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

Header Permintaan

Header	Diperlukan	Deskripsi
X-API-KEY	ya	Kunci API dengan izin billing.read
X-Real-IP	ya	Alamat dari daftar putih kunci

Permintaan ini tidak memiliki parameter.

Contoh

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"
}

Sebuah batas

Bidang	Deskripsi
id	nomor batas — gunakan ini untuk mengubah, menonaktifkan, atau mengaktifkan batas Anda sendiri
scope	account — berlaku untuk seluruh akun; key — berlaku untuk satu kunci API (apiKeyId)
origin	netts — ditetapkan oleh Netts, hanya-baca; client — batas Anda sendiri
editable, canDisable	apakah Anda dapat mengubah atau menonaktifkan batas ini
period	outstanding, day, week, atau order — lihat apa yang dihitung
productCode	produk yang diberlakukan batas tersebut, null untuk batas keseluruhan
enabled	false — batas dinonaktifkan dan tidak berlaku
revision	versi saat ini; kirimkan sebagai expectedRevision saat Anda mengubah batas
limit, equivalent	batas dan, sebagai referensi, nilainya dalam mata uang lain pada nilai tukar saat ini
used, available	berapa banyak yang terpakai dan tersisa; null untuk batas yang dinonaktifkan dan untuk batas order
creditApplied	kredit dari kelebihan pembayaran yang dihitung dalam batas outstanding
maxPerOrder	untuk batas order: pesanan tunggal terbesar
periodStart, periodEnd	untuk day dan week: periode UTC saat ini
cappedBy	batas Anda lebih tinggi daripada batas Netts setelah Netts menurunkannya: id batas Netts yang berlaku sebagai gantinya
status	ok, limit_reached, disabled, other_key (batas dari kunci Anda yang lain), atau unavailable

Produk

products menunjukkan, untuk setiap produk, berapa banyak yang dapat digunakan oleh pesanan berikutnya dari produk tersebut: spendable adalah jumlah tersisa terkecil di antara semua batas yang berlaku, dan limitingLimitIds menyebutkan batas-batas yang menetapkannya. maxPerOrder adalah pesanan tunggal terbesar jika batas order berlaku.

Batas kunci dihitung untuk kunci yang membuat permintaan ini — checkedApiKeyId. Jika angka-angka tersebut tidak dapat dihitung saat ini, valuationStatus adalah unavailable: batas tetap dicantumkan, used, available, dan spendable bernilai null. Keduanya tidak pernah ditampilkan sebagai nol atau tak terbatas dalam kasus tersebut.

Respons Kesalahan

HTTP	code	Arti
401	-1, -2	kunci tidak ada atau tidak valid, atau IP tidak masuk daftar putih — dijawab oleh gateway API, lihat format respons
403	billing_read_required	kunci tidak memiliki izin billing.read
403	postpaid_required	akun tidak memiliki penagihan pascabayar

Semua kode tercantum dalam penagihan pascabayar.