GET /apiv2/billing/limits

Faturalı (postpaid) hesabınızdaki her limit — Netts tarafından belirlenen kredi limiti ve kendi limitleriniz — her birinin ne kadarının kullanıldığı ve kaldığı, ayrıca her ürünün hâlâ ne kadar harcayabileceği bilgisiyle birlikte. Faturalı faturalandırma bölümünün bir parçasıdır.

Uç Nokta URL'si

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

İstek Başlıkları

Başlık	Gerekli	Açıklama
`X-API-KEY`	evet	`billing.read` iznine sahip API anahtarı
`X-Real-IP`	evet	Anahtarın beyaz listesinden bir adres

İsteğin hiçbir parametresi yoktur.

Örnek

bash

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

json

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

Bir limit

Alan	Açıklama
`id`	limit numarası — kendi limitinizi değiştirmek, kapatmak veya açmak için bunu kullanın
`scope`	`account` — tüm hesaba uygulanır; `key` — tek bir API anahtarına (`apiKeyId`) uygulanır
`origin`	`netts` — Netts tarafından belirlenir, salt okunurdur; `client` — kendi limitiniz
`editable`, `canDisable`	bu limiti değiştirip değiştiremeyeceğiniz veya kapatıp kapatamayacağınız
`period`	`outstanding`, `day`, `week` veya `order` — neyin sayıldığına bakın
`productCode`	limitin uygulandığı ürün, genel bir limit için `null`
`enabled`	`false` — limit kapalıdır ve uygulanmaz
`revision`	geçerli sürüm; limiti değiştirdiğinizde bunu `expectedRevision` olarak gönderin
`limit`, `equivalent`	limit ve referans amacıyla mevcut kur üzerinden diğer para birimindeki değeri
`used`, `available`	ne kadarının kullanıldığı ve kaldığı; devre dışı bırakılmış bir limit ve `order` limitleri için `null`
`creditApplied`	bir `outstanding` limitinde hesaba katılan fazla ödemelerden gelen kredi
`maxPerOrder`	bir `order` limiti için: en büyük tek sipariş
`periodStart`, `periodEnd`	`day` ve `week` için: geçerli UTC dönemi
`cappedBy`	Netts limiti düşürdükten sonra limitiniz Netts limitinden yüksekse: bunun yerine uygulanan Netts limiti `id` değeri
`status`	`ok`, `limit_reached`, `disabled`, `other_key` (başka bir anahtarınızın limiti) veya `unavailable`

Ürünler

products, her ürün için söz konusu ürünün bir sonraki siparişinin ne kadar harcayabileceğini gösterir: spendable, geçerli tüm limitler arasında kalan en küçük tutardır ve limitingLimitIds bunu belirleyen limitleri adlandırır. Bir order limiti geçerliyse maxPerOrder en büyük tek sipariştir.

Anahtar limitleri, bu isteği yapan anahtar (checkedApiKeyId) için sayılır. Sayılar şu anda hesaplanamıyorsa valuationStatus değeri unavailable olur: limitler yine de listelenir, used, available ve spendable değerleri null olur. Bu durumda asla sıfır veya sınırsız olarak gösterilmezler.

Hatalar

HTTP	`code`	Anlamı
401	`-1`, `-2`	anahtar eksik veya geçersiz ya da IP beyaz listede değil — API ağ geçidi tarafından yanıtlanır, bkz. yanıt formatı
403	`billing_read_required`	anahtarın `billing.read` izni yok
403	`postpaid_required`	hesabın faturalı faturalandırması yok

Tüm kodlar faturalı faturalandırma bölümünde listelenmiştir.

GET /apiv2/billing/limits ​

Uç Nokta URL'si ​

İstek Başlıkları ​

Örnek ​

Bir limit ​

Ürünler ​

Hatalar ​