GET Balance v2

Баланс организации и сумма, доступная к трате

GET Balance v2

Баланс организации и сумма, доступная к трате.

Версия 2 отличается от GET /v1/balance семантикой поля amount: здесь это всегда полный баланс организации (кошелёк), а сколько именно можно потратить — отдельное поле available. Используйте v2 в новом коде.

Примеры

curl "https://api.usellm.ru/v2/balance" \
  -H "Authorization: Bearer <USELLM_API_KEY>"

Ответ (200)

{
  "amount": "1234.56000000",
  "available": "1200.06000000",
  "reservedAmount": "12.50000000",
  "spentAmount": "845.30000000",
  "updatedAt": "2026-04-30T12:00:00.000Z"
}
ПолеТипОписание
amountstringБаланс организации в рублях (кошелёк). Всегда полный остаток, без учёта лимитов
availablestringДоступно к трате: остаток за вычетом резерва под выполняющиеся запросы, не больше остатков лимитов расходов ключа и участника
reservedAmountstringЗарезервировано под выполняющиеся запросы. Не возвращается, если у участника, на которого выпущен ключ, задан личный лимит расходов
spentAmountstringПотрачено организацией за всё время. Не возвращается при личном лимите участника
updatedAtstringВремя последнего обновления баланса (ISO 8601)

Все суммы — строки с восемью знаками после точки. Для проверки «хватит ли денег на запрос» ориентируйтесь на available: во время выполняющихся запросов оно меньше amount на сумму резерва и снова сравнивается с ним после завершения.

Ответ кэшируется на 1 секунду. Пополнить баланс можно в консоли через банковскую карту, СБП или счёт для юридических лиц.