GET /apiv2/billing/account

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

URL эндпоинта

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

Заголовки запроса

Заголовок	Обязательный	Описание
X-API-KEY	да	API-ключ с разрешением billing.read
X-Real-IP	да	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 — это то, что может быть использовано следующим заказом. Продуктовые лимиты приведены в разделе лимиты.

Ошибки

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

Все коды перечислены в разделе постоплатный биллинг.