Счёт платформы

Владелец и админ по сессии или ключ API, чей создатель всё ещё владелец или админ организации. Баланс, потолок, автопополнение и траты месяца.

Доступно по ключу API.

GET /v1/workspaces/{ws}/platform/account

Счёт платформы

cURL

curl --request GET \
  --url https://api.tungo.kz/v1/workspaces/{ws}/platform/account \
  --cookie tungo.session_token=

200

{
  "enabled": true,
  "balance_tiyn": 123,
  "monthly_cap_tiyn": 123,
  "month": "2026-11-01",
  "auto_reload": {
    "enabled": true,
    "threshold_tiyn": 123,
    "amount_tiyn": 123,
    "monthly_limit_tiyn": 123
  },
  "spent_tiyn": 123,
  "blocked_reason": "disabled",
  "purchase_limits": {
    "min_tiyn": 123,
    "max_tiyn": 123,
    "daily_max_tiyn": 123
  },
  "auto_reload_spent_tiyn": 123
}

Авторизации

sessionapiKeybearerKey

tungo.session_token · string · cookie · обязательно

Сессия кабинета: cookie ставит вход через /v1/auth/* (Better Auth), браузер шлёт её сам — фронтенду кабинета ничего добавлять не нужно (fetch с credentials: 'include'). За HTTPS имя cookie — __Secure-tungo.session_token. Сессия кончилась — 401 authentication_error: отправить на вход.

Параметры пути

ws · string · обязательно

id организации (workspace), ws_… — из GET /v1/workspaces

Ответ

200

application/json

Счёт

Счёт платформы для разработчиков: баланс, настройки и траты месяца; ключу на часть компаний — только баланс и потолок. С чатом не пересекается.

enabled · boolean · обязательно

Выключатель платформы: false — вызовы по ключам и автоматизации останавливаются (402 platform_disabled)

balance_tiyn · integer · обязательно

Баланс платформы в тиынах (1 ₸ = 100 тиын; показывать значение / 100 ₸)

monthly_cap_tiyn · integer | null · обязательно

Месячный потолок трат в тиынах (1 ₸ = 100 тиын; показывать значение / 100 ₸); null — без потолка

month · string · обязательно

Месяц по Алматы — его первое число, ГГГГ-ММ-ДД (календарная дата, без пояса — не переводить)

Пример:

"2026-11-01"

auto_reload · object

Автопополнение баланса платформы.

Show child attributes

spent_tiyn · integer

Траты платформы за этот месяц. Нет у ключа на часть компаний в тиынах (1 ₸ = 100 тиын; показывать значение / 100 ₸)

blocked_reason · enum<string> | null

Почему вызовы сейчас не пройдут: disabled — платформа выключена, cap — достигнут месячный потолок, balance — баланс закончился; null — всё в порядке. Нет у ключа на часть компаний

Доступные опции: disabled, cap, balance, null

purchase_limits · object

Границы суммы пополнения. Нет у ключа на часть компаний

Show child attributes

auto_reload_spent_tiyn · integer

Сколько автопополнение списало за этот месяц. Нет у ключа на часть компаний в тиынах (1 ₸ = 100 тиын; показывать значение / 100 ₸)