GET /apiv2/billing/account

Su cuenta de pospago de un vistazo: el límite de crédito establecido por Netts, su propio límite global, lo que debe y cuánto puede gastar todavía en este momento. Parte de la facturación pospago.

URL del endpoint

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

Encabezados de solicitud

Header	Required	Description
`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

La solicitud no tiene parámetros.

Ejemplos

bash

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

json

{
  "success": true,
  "data": {
    "mode": "postpaid",
    "adminLimit": {
      "id": 1,
      "origin": "netts",
      "limit": { "unit": "USD", "value": "30000.000000" },
      "used": { "unit": "USD", "value": "1250.400000" },
      "available": { "unit": "USD", "value": "28749.600000" },
      "creditApplied": { "unit": "USD", "value": "0" },
      "status": "ok",
      "revision": 3,
      "editable": false
    },
    "clientLimit": {
      "id": 4,
      "origin": "client",
      "limit": { "unit": "USD", "value": "5000.000000" },
      "used": { "unit": "USD", "value": "1250.400000" },
      "available": { "unit": "USD", "value": "3749.600000" },
      "creditApplied": { "unit": "USD", "value": "0" },
      "status": "ok",
      "revision": 2,
      "editable": true
    },
    "effectiveAvailable": { "unit": "USD", "value": "3749.600000" },
    "pendingUnbilled": { "trx": "0", "count": 0 },
    "asOf": "2026-10-19T20:24:26.474237+00:00",
    "settlement": { "asset": "USDC", "network": "ethereum", "paymentTermsDays": 5 },
    "limit": { "unit": "USD", "value": "30000.000000" },
    "unpaid": { "TRX": "3778.500000", "USDC": "1250.400000" },
    "creditUsdc": "0",
    "available": "28749.600000",
    "availableTrxEquiv": "86897.437285",
    "availableUsdEquiv": "28749.600000",
    "fx": { "usdPerTrx": "0.33084276", "at": "2026-10-19T20:24:23.449930+00:00" },
    "fxStatus": "ok"
  },
  "timestamp": "2026-10-19T20:24:26+00:00"
}

Campos de respuesta

Field	Description
`mode`	`postpaid`, o `prepaid` mientras la facturación pospago de la cuenta esté pausada
`adminLimit`	el límite de crédito establecido por Netts. `editable` siempre es `false`
`clientLimit`	su propio límite global, o `null` si no ha configurado uno
`adminLimit.used` / `clientLimit.used`	qué parte del límite se ha utilizado
`adminLimit.available` / `clientLimit.available`	cuánto queda del límite
`creditApplied`	su crédito procedente de pagos en exceso que ya reduce la deuda en este límite
`status`	`ok`, `limit_reached`, o `unavailable` si no se puede calcular en este momento
`effectiveAvailable`	lo que puede gastar ahora: el menor de los dos valores de `available`
`pendingUnbilled`	pedidos ya aceptados cuyo cargo aún se está registrando: su total en TRX y la cantidad
`asOf`	el momento en el que se calcularon los números
`settlement`	cómo paga las facturas según su contrato: la moneda, la red y los días para pagar una factura
`limit`, `unpaid`, `creditUsdc`, `available`	el límite de Netts, el importe pendiente de pago en TRX y en la moneda de su contrato, su crédito y lo que queda del límite de Netts
`availableTrxEquiv`, `availableUsdEquiv`	`available` convertido al tipo de cambio en `fx`; `null` cuando no hay ningún tipo de cambio disponible
`fx`	el tipo de cambio actual de TRX respecto a la moneda de su contrato y el momento en el que se tomó. Es una estimación para comparación, no el tipo de cambio de un pedido futuro — consulte recorded exchange rate
`fxStatus`	`ok`, o `unavailable` — en ese caso los equivalentes son `null`, pero los importes se siguen mostrando

used y available se calculan de la misma forma en que se verifica un pedido, por lo que effectiveAvailable es lo que puede utilizar el siguiente pedido. Los límites por producto se muestran en limits.

Respuestas de error

HTTP	`code`	Meaning
401	`-1`, `-2`	la clave falta o no es válida, o la IP no está en la lista blanca — respuesta emitida por la pasarela de API, consulte response format
403	`billing_read_required`	la clave no tiene el permiso `billing.read`
403	`postpaid_required`	la cuenta no tiene facturación pospago

Todos los códigos se enumeran en postpaid billing.

GET /apiv2/billing/account ​

URL del endpoint ​

Encabezados de solicitud ​

Ejemplos ​

Campos de respuesta ​