GET /apiv2/billing/limits

Каждый лимит на вашем постоплатном аккаунте — кредитный лимит, установленный Netts, и ваши собственные лимиты — с информацией о том, сколько из них использовано и сколько осталось, а также сколько еще можно потратить на каждый продукт. Часть раздела постоплатный биллинг.

URL эндпоинта

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

Заголовки запроса

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

У запроса нет параметров.

Примеры

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

Лимит

Поле	Описание
`id`	номер лимита — используйте его, чтобы изменить, отключить или включить собственный лимит
`scope`	`account` — применяется ко всему аккаунту; `key` — применяется к одному API-ключу (`apiKeyId`)
`origin`	`netts` — установлен Netts, доступен только для чтения; `client` — ваш собственный лимит
`editable`, `canDisable`	возможность изменить или отключить этот лимит
`period`	`outstanding`, `day`, `week` или `order` — см. что учитывается
`productCode`	продукт, к которому применяется лимит; `null` для общего лимита
`enabled`	`false` — лимит отключен и не применяется
`revision`	текущая версия; передавайте ее как `expectedRevision` при изменении лимита
`limit`, `equivalent`	лимит и, для справки, его значение в другой валюте по текущему курсу
`used`, `available`	сколько израсходовано и осталось; `null` для отключенного лимита и лимитов типа `order`
`creditApplied`	кредит от переплат, учтенный в лимите `outstanding`
`maxPerOrder`	для лимита `order`: максимальный размер единичного заказа
`periodStart`, `periodEnd`	для `day` и `week`: текущий период в UTC
`cappedBy`	ваш лимит превышает лимит Netts после того, как Netts снизил его: `id` лимита Netts, который применяется вместо него
`status`	`ok`, `limit_reached`, `disabled`, `other_key` (лимит другого вашего ключа) или `unavailable`

Продукты

Поле products показывает для каждого продукта, какую сумму может использовать следующий заказ этого продукта: spendable — это наименьшая оставшаяся сумма среди всех применимых лимитов, а limitingLimitIds перечисляет лимиты, которые ее определяют. Поле maxPerOrder указывает максимальный размер единичного заказа, если действует лимит типа order.

Лимиты ключа рассчитываются для того ключа, с помощью которого был сделан этот запрос — checkedApiKeyId. Если значения не могут быть вычислены в данный момент, valuationStatus принимает значение unavailable: лимиты по-прежнему перечисляются, но поля used, available и spendable равны null. В этом случае они никогда не отображаются как нулевые или неограниченные.

Ответы с ошибкой

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

Все коды перечислены в разделе постоплатный биллинг.

GET /apiv2/billing/limits ​

URL эндпоинта ​

Заголовки запроса ​

Примеры ​

Лимит ​

Продукты ​

Ответы с ошибкой ​