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"
}
| Поле | Тип | Описание |
|---|---|---|
amount | string | Баланс организации в рублях (кошелёк). Всегда полный остаток, без учёта лимитов |
available | string | Доступно к трате: остаток за вычетом резерва под выполняющиеся запросы, не больше остатков лимитов расходов ключа и участника |
reservedAmount | string | Зарезервировано под выполняющиеся запросы. Не возвращается, если у участника, на которого выпущен ключ, задан личный лимит расходов |
spentAmount | string | Потрачено организацией за всё время. Не возвращается при личном лимите участника |
updatedAt | string | Время последнего обновления баланса (ISO 8601) |
Все суммы — строки с восемью знаками после точки. Для проверки «хватит ли денег на запрос» ориентируйтесь на available: во время выполняющихся запросов оно меньше amount на сумму резерва и снова сравнивается с ним после завершения.
Ответ кэшируется на 1 секунду. Пополнить баланс можно в консоли через банковскую карту, СБП или счёт для юридических лиц.