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

Примеры

Ответ (200)

Все суммы — строки с восемью знаками после точки. Для проверки «хватит ли денег на запрос» ориентируйтесь на available: во время выполняющихся запросов оно меньше amount на сумму резерва и снова сравнивается с ним после завершения.
Ответ кэшируется на 1 секунду. Пополнить баланс можно в консоли через банковскую карту, СБП или счёт для юридических лиц.

Авторизации

Authorization
string
header
обязательно

API ключ передаётся в заголовке: Authorization: Bearer <POLZA_AI_API_KEY>

Ответ

200 - application/json

Баланс организации

amount
string
обязательно

Баланс организации в рублях (кошелёк). Всегда полный остаток организации; «сколько можно потратить» — поле available.

Пример:

"1234.56000000"

available
string
обязательно

Доступно к трате в рублях: остаток организации за вычетом резерва под выполняющиеся запросы, не больше остатков лимитов расходов ключа и участника.

Пример:

"1200.06000000"

updatedAt
string<date-time>
обязательно

Время последнего обновления баланса

Пример:

"2026-04-30T12:00:00.000Z"

reservedAmount
string

Зарезервировано под выполняющиеся запросы организации. Не возвращается, если у участника задан личный лимит расходов.

Пример:

"12.50000000"

spentAmount
string

Всего потрачено организацией за всё время. Не возвращается, если у участника задан личный лимит расходов.

Пример:

"845.30000000"