> ## Documentation Index
> Fetch the complete documentation index at: https://polza.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GET Balance v2

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

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

## Примеры

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://polza.ai/api/v2/balance" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://polza.ai/api/v2/balance',
      headers={'Authorization': 'Bearer YOUR_API_KEY'}
  )

  data = response.json()
  print(f"Баланс: {data['amount']} руб., доступно: {data['available']} руб.")
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://polza.ai/api/v2/balance', {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  });

  const data = await response.json();
  console.log(`Баланс: ${data.amount} руб., доступно: ${data.available} руб.`);
  ```
</CodeGroup>

## Ответ (200)

```json theme={null}
{
  "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` на сумму резерва и снова сравнивается с ним после завершения.

<Note>
  Ответ кэшируется на 1 секунду. Пополнить баланс можно в [консоли](https://polza.ai/dashboard) через банковскую карту, СБП или счёт для юридических лиц.
</Note>


## OpenAPI

````yaml GET /v2/balance
openapi: 3.0.0
info:
  title: Polza.ai API
  description: AI агрегатор — унифицированный доступ к сотням AI моделей
  version: '1.0'
  contact: {}
servers:
  - url: https://polza.ai/api
    description: Production
security: []
tags: []
paths:
  /v2/balance:
    get:
      tags:
        - Публичный API
      summary: Получить баланс организации (v2)
      description: >-
        Возвращает баланс организации, к которой привязан токен/ключ. amount —
        всегда кошелёк организации; available — «сколько можно потратить» с
        учётом резерва и лимитов расходов ключа и участника. Ответ кэшируется на
        1 секунду.
      operationId: PublicBalanceV2Controller_getBalance
      parameters: []
      responses:
        '200':
          description: Баланс организации
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicBalanceV2Presenter'
      security:
        - bearer: []
components:
  schemas:
    PublicBalanceV2Presenter:
      type: object
      properties:
        amount:
          type: string
          description: >-
            Баланс организации в рублях (кошелёк). Всегда полный остаток
            организации; «сколько можно потратить» — поле available.
          example: '1234.56000000'
        available:
          type: string
          description: >-
            Доступно к трате в рублях: остаток организации за вычетом резерва
            под выполняющиеся запросы, не больше остатков лимитов расходов ключа
            и участника.
          example: '1200.06000000'
        reservedAmount:
          type: string
          description: >-
            Зарезервировано под выполняющиеся запросы организации. Не
            возвращается, если у участника задан личный лимит расходов.
          example: '12.50000000'
        spentAmount:
          type: string
          description: >-
            Всего потрачено организацией за всё время. Не возвращается, если у
            участника задан личный лимит расходов.
          example: '845.30000000'
        updatedAt:
          type: string
          format: date-time
          description: Время последнего обновления баланса
          example: '2026-04-30T12:00:00.000Z'
      required:
        - amount
        - available
        - updatedAt
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: API Key
      type: http
      description: >-
        API ключ передаётся в заголовке: Authorization: Bearer
        <POLZA_AI_API_KEY>

````