GET /apiv2/billing/account

Короткий огляд вашого облікового запису з післяоплатою: кредитний ліміт, встановлений Netts, ваш власний загальний ліміт, сума заборгованості та скільки ви ще можете витратити просто зараз. Частина білінгу з післяоплатою.

URL кінцевої точки

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

Заголовки запиту

Заголовок	Обов'язковий	Опис
X-API-KEY	так	Ключ API з дозволом billing.read
X-Real-IP	так	Адреса з білого списку ключа

Запит не має параметрів.

Приклад

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

Поля відповіді

Поле	Опис
mode	postpaid, або prepaid, поки білінг облікового запису з післяоплатою призупинено
adminLimit	кредитний ліміт, встановлений Netts. editable завжди має значення false
clientLimit	ваш власний загальний ліміт, або null, якщо ви його не встановлювали
adminLimit.used / clientLimit.used	скільки коштів із ліміту використано
adminLimit.available / clientLimit.available	скільки коштів із ліміту залишилося
creditApplied	ваш кредит від переплат, який уже зменшує заборгованість у цьому ліміті
status	ok, limit_reached або unavailable, якщо його неможливо розрахувати прямо зараз
effectiveAvailable	скільки ви можете витратити зараз: менше з двох значень available
pendingUnbilled	уже прийняті замовлення, списання за якими все ще фіксується: їхня загальна сума в TRX та кількість
asOf	момент часу, на який було розраховано показники
settlement	як ви оплачуєте рахунки згідно з вашим договором: валюта, мережа та кількість днів на оплату рахунку
limit, unpaid, creditUsdc, available	ліміт Netts, неоплачена сума в TRX та у валюті вашого договору, ваш кредит і залишок ліміту Netts
availableTrxEquiv, availableUsdEquiv	available, конвертований за курсом у fx; null, якщо курс недоступний
fx	поточний курс TRX до валюти вашого договору та момент, коли його було зафіксовано. Це орієнтовне значення для порівняння, а не курс майбутнього замовлення — див. фіксований обмінний курс
fxStatus	ok або unavailable — у такому разі еквіваленти мають значення null, але суми все одно відображаються

used і available розраховуються так само, як і під час перевірки замовлення, тому effectiveAvailable — це те, що може бути використано для наступного замовлення. Ліміти продуктів наведено в розділі limits.

Помилки

HTTP	code	Значення
401	-1, -2	ключ відсутній або недійсний, або IP-адреса не входить до білого списку — відповідь надається шлюзом API, див. формат відповіді
403	billing_read_required	ключ не має дозволу billing.read
403	postpaid_required	для облікового запису не налаштовано післяоплату

Усі коди перелічені в розділі білінг з післяоплатою.