GET /apiv2/billing/usage

Suas cobranças pós-pagas: uma linha por componente cobrado separadamente de um pedido, as mais recentes primeiro. Uma linha aparece após o serviço ter sido fornecido e registrado, o que pode ocorrer depois da resposta do pedido. Use-a para reconciliar pedidos com o débito e com faturas. Parte do faturamento pós-pago.

URL do endpoint

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

Cabeçalhos da requisição

Cabeçalho	Obrigatório	Descrição
X-API-KEY	sim	Chave de API com a permissão billing.read
X-Real-IP	sim	Um endereço da lista de permissões da chave

Parâmetros de consulta

Parâmetro	Obrigatório	Descrição
from	não	cobranças a partir deste momento, ISO 8601 com fuso horário: 2026-10-01T00:00:00Z
to	não	cobranças anteriores a este momento, mesmo formato
limit	não	linhas por página, 1–500, padrão 100
cursor	não	nextCursor da página anterior

Um horário sem fuso horário é recusado com 400 invalid_request — o período seria ambíguo.

Exemplos

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

Uma cobrança

Campo	Descrição
id	o número da cobrança
orderId	o pedido ao qual esta cobrança pertence — o mesmo id retornado pelo endpoint de pedidos
productCode	energy_1h, energy_5m, bandwidth, activation ou aml_check
address	o endereço TRON para o qual o pedido foi feito
quantity	unidades de energy ou bandwidth, ou 1 para uma ativação ou verificação
unitPriceSun	o preço por unidade em SUN que foi cobrado de você, incluindo seu preço personalizado; null para produtos precificados por pedido
discount	um desconto separado neste pedido — type percent ou sun_per_unit e seu value — ou null
amountTrx, amountUsdc	o valor registrado deste componente, em TRX e na moeda do seu contrato
usdPerTrx	a taxa de TRX para a moeda do seu contrato registrada para este componente: de sua cotação se ela fixou o valor, caso contrário no momento em que o serviço foi fornecido
quoteId	a cotação utilizada pelo pedido, se houver
txHash	a transação TRON deste componente, quando houver
fulfilledAt	quando este componente foi fornecido, UTC
status	accrued — ainda não faturado; invoiced; paid; reversed — cancelado por uma correção posterior
paidTrx, paidUsdc	quanto da cobrança já foi pago, em TRX e na moeda do seu contrato
invoiceId	a fatura que a contém
reversesId	para uma linha de correção: a cobrança que ela cancela

Um pedido com energy e uma ativação possui duas linhas, uma por parte. Uma correção nunca edita uma linha antiga: ela adiciona uma nova com reversesId.

Páginas

Envie o valor de nextCursor como cursor para obter a página seguinte e mais antiga. nextCursor é null na última página.

Respostas de erro

HTTP	code	Significado
400	invalid_request	parâmetro incorreto, ou from/to sem fuso horário
401	-1, -2	a chave está ausente ou é inválida, ou o IP não está na lista de permissões — respondido pelo gateway da API, consulte o formato de resposta
403	billing_read_required, postpaid_required	sem permissão ou sem faturamento pós-pago