GET /apiv2/billing/invoices

Ваші рахунки за постоплатою. Наприкінці розрахункового періоду, визначеного у вашому договорі, виставляється рахунок за послуги цього періоду; кожен рахунок має термін оплати. Частина білінгу за постоплатою.

Кінцеві точки

Кінцева точка	Повертає
GET /apiv2/billing/invoices	усі рахунки, починаючи з найновішого періоду
GET /apiv2/billing/invoices/{id}	один рахунок із нарахуваннями за ним

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

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

Приклад

curl -s 'https://netts.io/apiv2/billing/invoices/12' \
  -H 'X-API-KEY: your-api-key' \
  -H 'X-Real-IP: 203.0.113.10'

{
  "success": true,
  "data": {
    "id": 12,
    "periodStart": "2026-10-12T00:00:00+00:00",
    "periodEnd": "2026-10-19T00:00:00+00:00",
    "totalTrx": "3778.500000",
    "totalUsdc": "1250.400000",
    "paidUsdc": "0.000000",
    "status": "issued",
    "issuedAt": "2026-10-19T00:10:00+00:00",
    "dueAt": "2026-10-24T00:10:00+00:00",
    "charges": [
      {
        "id": 1024,
        "orderId": "AB2EF201B582AA1",
        "productCode": "energy_1h",
        "amountTrx": "1.300000",
        "amountUsdc": "0.430096",
        "status": "invoiced"
      }
    ]
  },
  "timestamp": "2026-10-19T20:31:10+00:00"
}

Кожне нарахування містить ті самі поля, що й у розділі використання; у прикладі наведено кілька з них.

Рахунок

Поле	Опис
id	номер рахунку
periodStart, periodEnd	розрахунковий період, який охоплює рахунок, UTC
totalTrx, totalUsdc	загальна сума рахунку в TRX та у валюті вашого договору
paidUsdc	скільки вже сплачено у валюті вашого договору
status	issued, delivered, partially_paid, paid або void
issuedAt	коли рахунок було виставлено
dueAt	термін оплати
charges	лише в /invoices/{id}: нарахування за цим рахунком

Кінцева точка для отримання списку повертає ті самі поля без charges. Акаунт, у якого ще немає рахунків, отримує порожній список.

Помилки

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