GET /apiv2/billing/usage

Tus cargos de pospago: una línea por cada componente facturable por separado de una orden, los más recientes primero. Una línea aparece después de que el servicio haya sido suministrado y registrado, lo cual puede ser posterior a la respuesta de la orden. Utilízalo para conciliar órdenes con la deuda y con las facturas. Parte de la facturación de pospago.

URL del endpoint

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

Encabezados de solicitud

Encabezado	Requerido	Descripción
X-API-KEY	sí	Clave de API con el permiso billing.read
X-Real-IP	sí	Una dirección de la lista blanca de la clave

Parámetros de consulta

Parámetro	Requerido	Descripción
from	no	cargos desde este momento, ISO 8601 con zona horaria: 2026-10-01T00:00:00Z
to	no	cargos anteriores a este momento, mismo formato
limit	no	líneas por página, 1–500, predeterminado 100
cursor	no	nextCursor de la página anterior

Una hora sin zona horaria se rechaza con 400 invalid_request — el período sería ambiguo.

Ejemplo

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

Un cargo

Campo	Descripción
id	el número de cargo
orderId	la orden a la que pertenece este cargo — el mismo id que devolvió el endpoint de la orden
productCode	energy_1h, energy_5m, bandwidth, activation o aml_check
address	la dirección TRON para la cual fue la orden
quantity	unidades de energy o bandwidth, o 1 para una activación o una verificación
unitPriceSun	el precio por unidad en SUN que se te cobró, incluido tu precio personalizado; null para productos con precio por orden
discount	un descuento separado en esta orden — type percent o sun_per_unit y su value — o null
amountTrx, amountUsdc	el monto registrado de este componente, en TRX y en la moneda de tu contrato
usdPerTrx	el tipo de cambio de TRX respecto a la moneda de tu contrato registrado para este componente: de su cotización si esta fijó el monto, o en el momento en que se suministró el servicio
quoteId	la cotización que utilizó la orden, si la hubiera
txHash	la transacción TRON de este componente, cuando la hay
fulfilledAt	cuándo se suministró este componente, UTC
status	accrued — aún no facturado; invoiced; paid; reversed — cancelado por una corrección posterior
paidTrx, paidUsdc	qué parte del cargo ya está pagada, en TRX y en la moneda de tu contrato
invoiceId	la factura que lo contiene
reversesId	para una línea de corrección: el cargo que cancela

Una orden con energy y una activación tiene dos líneas, una por parte. Una corrección nunca edita una línea antigua: añade una nueva con reversesId.

Páginas

Envía el valor de nextCursor como cursor para obtener la página siguiente, más antigua. nextCursor es null en la última página.

Errores

HTTP	code	Significado
400	invalid_request	parámetro incorrecto, o from/to sin zona horaria
401	-1, -2	falta la clave o no es válida, o la IP no está en la lista blanca — respondido por la pasarela de la API, consulta el formato de respuesta
403	billing_read_required, postpaid_required	sin permiso, o sin facturación de pospago