# RUVDS API (legacy): GET /api/balance/ — Баланс

В ответе: `amount`, `currency` (1 RUB, 2 UAH, 3 USD, 4 EUR), при `details=1` — история (`income`, `debited`, `items`).

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `sessionToken` | query | string | да | Сессионный токен |
| `details` | query | integer | нет | 1 — с историей платежей |

Пример запроса:

```
https://ruvds.com/api/balance/?sessionToken=YOURTOKEN&details=0
```

## Базовые URL

- Боевой: `https://ruvds.com`

## Авторизация

Тип: Другое

Вызовите `/api/logon/` с персональным ключом API (`key` из настроек аккаунта), логином и паролем; полученный `sessionToken` передавайте параметром во всех последующих запросах. Токен храните только на своём сервере. Смена логина или пароля деактивирует все выданные токены.

```
https://ruvds.com/api/logon/?key=KEY&username=LOGIN&password=PASSWORD&endless=0
```

## Нюансы

- Запросы GET или POST, параметры — в строке запроса; ответы — JSON.
- В каждом ответе `rejectReason` (`0` — успех) и `errMessage`; коды ошибок свои у каждого метода.
- Методы управления пользователями (`/api/user/...`) отключены и доступны только юрлицам с партнёрским договором.
- Для тестов документация советует SSD-серверы и минимум запросов.

## Сценарии с этим методом

- [Следить за балансом и оплатой серверов](https://mcp-everything.ru/integrations/ruvds/scenarios/sledit-za-balansom-i-oplatoy-serverov.md)

---

Если этого недостаточно — официальная документация: https://ruvds.com/en-rub/use_api
Вся интеграция одним документом: https://mcp-everything.ru/integrations/ruvds.md