GET /apiv2/billing/usage

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

URL эндпоинта

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

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

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

Параметры запроса (Query)

Параметр	Обязательный	Описание
from	нет	начисления начиная с этого момента, ISO 8601 с часовым поясом: 2026-10-01T00:00:00Z
to	нет	начисления до этого момента, тот же формат
limit	нет	строк на странице, 1–500, по умолчанию 100
cursor	нет	значение nextCursor с предыдущей страницы

Время без часового пояса отклоняется с ошибкой 400 invalid_request — период был бы неоднозначным.

Примеры

curl -s 'https://netts.io/apiv2/billing/usage?from=2026-10-01T00:00:00Z&limit=2' \
  -H 'X-API-KEY: your-api-key' \
  -H 'X-Real-IP: 203.0.113.10'

{
  "success": true,
  "data": {
    "items": [
      {
        "id": 1024,
        "orderId": "AB2EF201B582AA1",
        "productCode": "energy_1h",
        "address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "quantity": 65000,
        "unitPriceSun": "20.000000",
        "discount": null,
        "amountTrx": "1.300000",
        "amountUsdc": "0.430096",
        "usdPerTrx": "0.330842760000000000",
        "quoteId": null,
        "txHash": "5c1f0e0d3a2b4c6d8e9f0a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f",
        "fulfilledAt": "2026-10-19T10:11:42.563494+00:00",
        "status": "accrued",
        "paidTrx": "0.000000",
        "paidUsdc": "0.000000",
        "invoiceId": null,
        "reversesId": null
      }
    ],
    "nextCursor": 1023
  },
  "timestamp": "2026-10-19T20:31:10+00:00"
}

Начисление

Поле	Описание
id	номер начисления
orderId	заказ, к которому относится это начисление — тот же идентификатор, который вернул эндпоинт заказа
productCode	energy_1h, energy_5m, bandwidth, activation или aml_check
address	адрес TRON, для которого был сделан заказ
quantity	единицы энергии или пропускной способности, либо 1 для активации или проверки
unitPriceSun	списанная цена за единицу в SUN с учетом вашей персональной цены; null для продуктов с фиксированной ценой за заказ
discount	отдельная скидка на этот заказ — type со значением percent или sun_per_unit и ее value — или null
amountTrx, amountUsdc	зафиксированная сумма этого компонента в TRX и в валюте вашего договора
usdPerTrx	курс TRX к валюте вашего договора, зафиксированный для этого компонента: из его котировки, если котировка зафиксировала сумму, в противном случае — на момент предоставления услуги
quoteId	котировка, использованная заказом, если таковая имелась
txHash	транзакция TRON для этого компонента, если она есть
fulfilledAt	когда этот компонент был предоставлен, UTC
status	accrued — счет еще не выставлен; invoiced; paid; reversed — отменено последующей корректировкой
paidTrx, paidUsdc	какая часть начисления уже оплачена, в TRX и в валюте вашего договора
invoiceId	счет, содержащий данное начисление
reversesId	для строки корректировки: начисление, которое она отменяет

Заказ с энергией и активацией содержит две строки, по одной на каждую часть. Корректировка никогда не изменяет старую строку: она добавляет новую с полем reversesId.

Пагинация

Передайте значение nextCursor в качестве параметра cursor, чтобы получить следующую, более старую страницу. На последней странице nextCursor равен null.

Ответы с ошибкой

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