GET /apiv2/billing/limits

Cada límite en su cuenta pospago —el límite de crédito establecido por Netts y sus propios límites— con cuánto de cada uno se ha utilizado y queda disponible, y cuánto puede gastar aún cada producto. Parte de la facturación pospago.

URL del endpoint

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

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

La solicitud no tiene parámetros.

Ejemplos

bash

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

json

{
  "success": true,
  "data": {
    "limits": [
      {
        "id": 1,
        "scope": "account",
        "origin": "netts",
        "editable": false,
        "canDisable": false,
        "period": "outstanding",
        "productCode": null,
        "apiKeyId": null,
        "enabled": true,
        "revision": 3,
        "limit": { "unit": "USD", "value": "30000.000000" },
        "equivalent": { "unit": "TRX", "value": "90677.230000" },
        "used": { "unit": "USD", "value": "1250.400000" },
        "available": { "unit": "USD", "value": "28749.600000" },
        "creditApplied": { "unit": "USD", "value": "0" },
        "status": "ok",
        "periodStart": null,
        "periodEnd": null,
        "cappedBy": null
      },
      {
        "id": 5,
        "scope": "account",
        "origin": "client",
        "editable": true,
        "canDisable": true,
        "period": "day",
        "productCode": "energy_5m",
        "apiKeyId": null,
        "enabled": true,
        "revision": 1,
        "limit": { "unit": "USD", "value": "200.000000" },
        "equivalent": { "unit": "TRX", "value": "604.514867" },
        "used": { "unit": "USD", "value": "35.200000" },
        "available": { "unit": "USD", "value": "164.800000" },
        "creditApplied": null,
        "status": "ok",
        "periodStart": "2026-10-19T00:00:00+00:00",
        "periodEnd": "2026-10-20T00:00:00+00:00",
        "cappedBy": null
      }
    ],
    "products": {
      "energy_1h": { "unit": "USD", "spendable": "28749.600000", "limitingLimitIds": [1], "maxPerOrder": null, "status": "ok" },
      "energy_5m": { "unit": "USD", "spendable": "164.800000", "limitingLimitIds": [5], "maxPerOrder": null, "status": "ok" }
    },
    "unit": "USD",
    "asOf": "2026-10-19T20:24:26.525887+00:00",
    "checkedApiKeyId": 6,
    "valuationStatus": "ok",
    "creditUsdc": "0",
    "fx": { "usdPerTrx": "0.33084276", "at": "2026-10-19T20:24:23.449930+00:00" },
    "fxStatus": "ok"
  },
  "timestamp": "2026-10-19T20:24:26+00:00"
}

Un límite

Campo	Descripción
`id`	el número de límite — utilícelo para modificar, desactivar o activar su propio límite
`scope`	`account` — se aplica a toda la cuenta; `key` — se aplica a una clave de API (`apiKeyId`)
`origin`	`netts` — establecido por Netts, de solo lectura; `client` — su propio límite
`editable`, `canDisable`	si puede modificar o desactivar este límite
`period`	`outstanding`, `day`, `week` u `order` — consulte qué se contabiliza
`productCode`	el producto al que se aplica el límite, `null` para un límite general
`enabled`	`false` — el límite está desactivado y no se aplica
`revision`	la versión actual; envíela como `expectedRevision` cuando modifique el límite
`limit`, `equivalent`	el límite y, como referencia, su valor en la otra moneda al tipo de cambio actual
`used`, `available`	cuánto se ha utilizado y queda disponible; `null` para un límite desactivado y para límites de tipo `order`
`creditApplied`	crédito por pagos en exceso contabilizado en un límite `outstanding`
`maxPerOrder`	para un límite de tipo `order`: el pedido individual más grande
`periodStart`, `periodEnd`	para `day` y `week`: el período UTC actual
`cappedBy`	su límite es superior al límite de Netts después de que Netts lo redujera: el `id` del límite de Netts que se aplica en su lugar
`status`	`ok`, `limit_reached`, `disabled`, `other_key` (un límite de otra de sus claves) o `unavailable`

Productos

products muestra, para cada producto, cuánto puede utilizar el próximo pedido de ese producto: spendable es la cantidad restante más baja entre todos los límites que aplican, y limitingLimitIds indica los límites que la determinan. maxPerOrder es el pedido individual más grande si se aplica un límite de tipo order.

Los límites de clave se contabilizan para la clave que realizó esta solicitud — checkedApiKeyId. Si las cifras no pueden calcularse en este momento, valuationStatus es unavailable: los límites se siguen listando, y used, available y spendable son null. En ese caso, nunca se muestran como cero o ilimitados.

Respuestas de error

HTTP	`code`	Significado
401	`-1`, `-2`	la clave falta o no es válida, o la IP no está en la lista blanca — respondido por la pasarela de la API, consulte el formato de respuesta
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 facturación pospago.

GET /apiv2/billing/limits ​

URL del endpoint ​

Encabezados de solicitud ​

Ejemplos ​

Un límite ​

Productos ​

Respuestas de error ​