GET /apiv2/billing/account

Your postpaid account at a glance: the credit limit set by Netts, your own overall limit, what you owe and how much you can still spend right now. Part of postpaid billing.

Endpoint URL

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

Request headers

Header	Required	Description
X-API-KEY	yes	API key with the billing.read permission
X-Real-IP	yes	An address from the key whitelist

The request has no parameters.

Example

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 fields

Field	Description
mode	postpaid, or prepaid while postpaid billing of the account is paused
adminLimit	the credit limit set by Netts. editable is always false
clientLimit	your own overall limit, or null if you have not set one
adminLimit.used / clientLimit.used	how much of the limit is taken
adminLimit.available / clientLimit.available	how much of the limit is left
creditApplied	your credit from overpayments that already reduces the debt in this limit
status	ok, limit_reached, or unavailable if it cannot be calculated right now
effectiveAvailable	what you can spend now: the smaller of the two available values
pendingUnbilled	orders already accepted whose charge is still being recorded: their TRX total and count
asOf	the moment the numbers were calculated
settlement	how you pay invoices under your contract: the currency, the network and the days to pay an invoice
limit, unpaid, creditUsdc, available	the Netts limit, the unpaid amount in TRX and in the currency of your contract, your credit, and what is left of the Netts limit
availableTrxEquiv, availableUsdEquiv	available converted at the rate in fx; null when no rate is available
fx	the current rate of TRX to the currency of your contract and the moment it was taken. It is an estimate for comparison, not the rate of a future order — see recorded exchange rate
fxStatus	ok, or unavailable — then the equivalents are null, amounts are still shown

used and available are calculated the same way an order is checked, so effectiveAvailable is what the next order can use. Product limits are shown in limits.

Errors

HTTP	code	Meaning
401	-1, -2	the key is missing or invalid, or the IP is not whitelisted — answered by the API gateway, see response format
403	billing_read_required	the key has no billing.read permission
403	postpaid_required	the account has no postpaid billing

All codes are listed in postpaid billing.