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	замовлення, до якого належить це нарахування — той самий id, який повернув ендпоінт замовлення
productCode	energy_1h, energy_5m, bandwidth, activation або aml_check
address	TRON-адреса, для якої було створено замовлення
quantity	одиниці Energy або Bandwidth, або 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	для рядка коригування: нарахування, яке він скасовує

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

Сторінки

Надішліть значення nextCursor як cursor, щоб отримати наступну, старішу сторінку. nextCursor має значення null на останній сторінці.

Відповіді з помилками

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