> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.speech.palatine.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Баланс своего аккаунта

> Вернуть баланс аккаунта, которому принадлежит токен.

Идентификатор пользователя берётся **только** из токена авторизации — чужой
баланс получить нельзя ни при каких параметрах запроса.

Отвечает `503`, если биллинг недоступен или вернул неизвестную форму ответа.
Нулевой баланс вместо ответа «не знаю» не отдаётся никогда: баланс — основание
для решений клиента, и ложный ноль остановил бы его пайплайн без причины.



## OpenAPI

````yaml get /api/v1/account/balance
openapi: 3.1.0
info:
  title: Palatine Cloud API
  description: >-
    Облачный API для транскрипции аудио, диаризации, анализа тональности и AI
    суммаризации
  version: 2.0.0
servers:
  - url: https://api.palatine.ru
    description: Продакшн сервер
security: []
paths:
  /api/v1/account/balance:
    get:
      tags:
        - Account
      summary: Баланс своего аккаунта
      description: >-
        Вернуть баланс аккаунта, которому принадлежит токен.


        Идентификатор пользователя берётся **только** из токена авторизации —
        чужой

        баланс получить нельзя ни при каких параметрах запроса.


        Отвечает `503`, если биллинг недоступен или вернул неизвестную форму
        ответа.

        Нулевой баланс вместо ответа «не знаю» не отдаётся никогда: баланс —
        основание

        для решений клиента, и ложный ноль остановил бы его пайплайн без
        причины.
      operationId: get_my_balance_api_v1_account_balance_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BalanceResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    BalanceResponse:
      properties:
        real_money:
          $ref: '#/components/schemas/WalletAmount'
          description: Оплаченные деньги.
        virtual_money:
          $ref: '#/components/schemas/WalletAmount'
          description: Бонусный кошелёк.
      type: object
      required:
        - real_money
        - virtual_money
      title: BalanceResponse
      description: Баланс владельца токена.
    WalletAmount:
      properties:
        amount:
          type: string
          title: Amount
          description: >-
            Сумма на кошельке. Строка, а НЕ число: деньги нельзя гонять через
            float без потери точности.
        currency:
          type: string
          title: Currency
          description: Код валюты, например RUB.
      type: object
      required:
        - amount
        - currency
      title: WalletAmount
      description: 'Кошелёк: сумма и валюта.'
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````