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

# Get Traffic Usage

> Get paginated per-user traffic usage by node.



## OpenAPI

````yaml /openapi.json get /cabinet/admin/traffic
openapi: 3.1.0
info:
  title: Remnawave Bot Admin API
  version: 1.0.0
servers: []
security: []
tags:
  - name: health
    description: Проверка состояния сервера и базы данных
  - name: stats
    description: Общая и детальная статистика системы
  - name: logs
    description: Просмотр логов и ошибок
  - name: users
    description: Управление пользователями бота
  - name: subscriptions
    description: Управление подписками и ключами подключения
  - name: transactions
    description: Финансовые операции и платежи
  - name: partners
    description: Партнёрская программа
  - name: broadcasts
    description: Массовые рассылки пользователям
  - name: pages
    description: Информационные страницы (оферта, политика и др.)
  - name: welcome-texts
    description: Приветственные сообщения
  - name: main-menu
    description: Настройки главного меню бота
  - name: menu-layout
    description: Конструктор расположения кнопок меню
  - name: pinned-messages
    description: Закреплённые сообщения в чатах
  - name: notifications
    description: Системные уведомления
  - name: promo-codes
    description: Промокоды для скидок и бонусов
  - name: promo-groups
    description: Группы промо-акций
  - name: promo-offers
    description: Рекламные предложения
  - name: campaigns
    description: Рекламные кампании с UTM-трекингом
  - name: contests
    description: Конкурсы, розыгрыши и ежедневные задания
  - name: polls
    description: Опросы пользователей
  - name: remnawave
    description: RemnaWave интеграция (ноды, сквады, инбаунды)
  - name: servers
    description: Управление VPN-серверами
  - name: settings
    description: Настройки бота
  - name: backups
    description: Резервное копирование данных
  - name: auth
    description: Аутентификация и токены Web API
  - name: webhooks
    description: Webhook-обработчики внешних событий
  - name: miniapp
    description: API для Telegram Mini App
  - name: media
    description: Загрузка и хранение медиафайлов
  - name: support
    description: Система тикетов поддержки
  - name: ban-notifications
    description: Уведомления о банах пользователей
  - name: Landing Pages
    description: Публичные лендинги для привлечения клиентов
  - name: Cabinet Auth
    description: Авторизация через Telegram, email, виджет
  - name: Cabinet OAuth
    description: OAuth 2.0 провайдеры (Google, Яндекс, Discord, VK)
  - name: Cabinet Account Linking
    description: Привязка и отвязка аккаунтов провайдеров
  - name: Cabinet Account Merge
    description: Объединение нескольких аккаунтов в один
  - name: Cabinet Subscription
    description: Управление подписками, тарифами и ключами
  - name: Cabinet Balance
    description: Баланс, пополнение и сохранённые карты
  - name: Cabinet Gift
    description: Подарочные подписки — покупка и активация
  - name: Fortune Wheel
    description: Колесо фортуны с бонусами
  - name: Cabinet Withdrawal
    description: Вывод партнёрских средств
  - name: Cabinet Referral
    description: Реферальная программа
  - name: Cabinet Partner
    description: Партнёрская программа для пользователей
  - name: Cabinet Promo
    description: Промо-акции в личном кабинете
  - name: Cabinet Promocode
    description: Применение промокодов
  - name: Cabinet Contests
    description: Участие в конкурсах
  - name: Cabinet Polls
    description: Участие в опросах
  - name: Cabinet Tickets
    description: Тикеты поддержки
  - name: Cabinet Ticket Notifications
    description: Уведомления по тикетам
  - name: Cabinet Notifications
    description: Системные уведомления
  - name: Cabinet Info
    description: Информация о сервисе, FAQ, контакты
  - name: Cabinet Media
    description: Медиафайлы личного кабинета
  - name: Branding
    description: Брендирование и оформление кабинета
  - name: Cabinet Admin Users
    description: Управление пользователями через админ-панель
  - name: Cabinet Admin Ban System
    description: Система банов и блокировок
  - name: Admin RBAC
    description: Управление ролями и разрешениями
  - name: Admin RBAC Policies
    description: Политики контроля доступа
  - name: Admin RBAC Audit Log
    description: Журнал аудита действий
  - name: Cabinet Admin Tariffs
    description: Управление тарифами
  - name: Cabinet Admin Servers
    description: Управление серверами
  - name: Cabinet Admin RemnaWave
    description: RemnaWave интеграция из админ-панели
  - name: Cabinet Admin Payments
    description: Просмотр и управление платежами
  - name: Cabinet Admin Payment Methods
    description: Настройка способов оплаты
  - name: Admin Traffic
    description: Мониторинг трафика
  - name: Cabinet Admin Broadcasts
    description: Массовые рассылки из админ-панели
  - name: Cabinet Admin Campaigns
    description: Управление рекламными кампаниями
  - name: Cabinet Admin Channels
    description: Обязательные подписки на каналы
  - name: Cabinet Admin Pinned Messages
    description: Закреплённые сообщения
  - name: Cabinet Admin Landings
    description: Управление лендинговыми страницами
  - name: Cabinet Admin Apps
    description: VPN-приложения для скачивания
  - name: Cabinet Admin Updates
    description: Проверка обновлений бота
  - name: Admin Menu Layout
    description: Конструктор меню админ-панели
  - name: Admin Promo Groups
    description: Управление промо-группами
  - name: Admin Promo Offers
    description: Управление промо-предложениями
  - name: Admin Promocodes
    description: Управление промокодами
  - name: Admin Fortune Wheel
    description: Настройка колеса фортуны
  - name: Admin Email Templates
    description: Email-шаблоны
  - name: Admin Button Styles
    description: Стили кнопок интерфейса
  - name: Cabinet Admin Stats
    description: Статистика и аналитика
  - name: Cabinet Admin Sales Stats
    description: Статистика продаж и доходов
  - name: Cabinet Admin Referral Network
    description: Граф реферальной сети
  - name: Cabinet Admin Partners
    description: Управление партнёрами
  - name: Cabinet Admin Tickets
    description: Тикеты поддержки из админ-панели
  - name: Cabinet Admin Ticket Notifications
    description: Уведомления по тикетам
  - name: Cabinet Admin Withdrawals
    description: Выводы партнёрских средств
  - name: Admin Settings
    description: Системные настройки
paths:
  /cabinet/admin/traffic:
    get:
      tags:
        - Admin Traffic
      summary: Get Traffic Usage
      description: Get paginated per-user traffic usage by node.
      operationId: get_traffic_usage_cabinet_admin_traffic_get
      parameters:
        - name: period
          in: query
          required: false
          schema:
            type: integer
            maximum: 30
            minimum: 1
            title: Period
            default: 30
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 200
            minimum: 1
            default: 50
            title: Limit
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            default: 0
            title: Offset
        - name: search
          in: query
          required: false
          schema:
            type: string
            maxLength: 100
            default: ''
            title: Search
        - name: sort_by
          in: query
          required: false
          schema:
            type: string
            maxLength: 100
            default: total_bytes
            title: Sort By
        - name: sort_desc
          in: query
          required: false
          schema:
            type: boolean
            default: true
            title: Sort Desc
        - name: tariffs
          in: query
          required: false
          schema:
            type: string
            maxLength: 500
            default: ''
            title: Tariffs
        - name: statuses
          in: query
          required: false
          schema:
            type: string
            maxLength: 500
            default: ''
            title: Statuses
        - name: nodes
          in: query
          required: false
          schema:
            type: string
            maxLength: 2000
            default: ''
            title: Nodes
        - name: start_date
          in: query
          required: false
          schema:
            type: string
            maxLength: 10
            default: ''
            title: Start Date
        - name: end_date
          in: query
          required: false
          schema:
            type: string
            maxLength: 10
            default: ''
            title: End Date
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TrafficUsageResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    TrafficUsageResponse:
      properties:
        items:
          items:
            $ref: '#/components/schemas/UserTrafficItem'
          type: array
          title: Items
        nodes:
          items:
            $ref: '#/components/schemas/TrafficNodeInfo'
          type: array
          title: Nodes
        total:
          type: integer
          title: Total
        offset:
          type: integer
          title: Offset
        limit:
          type: integer
          title: Limit
        period_days:
          type: integer
          title: Period Days
        available_tariffs:
          items:
            type: string
          type: array
          title: Available Tariffs
        available_statuses:
          items:
            type: string
          type: array
          title: Available Statuses
      type: object
      required:
        - items
        - nodes
        - total
        - offset
        - limit
        - period_days
        - available_tariffs
        - available_statuses
      title: TrafficUsageResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    UserTrafficItem:
      properties:
        user_id:
          type: integer
          title: User Id
        telegram_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Telegram Id
        username:
          anyOf:
            - type: string
            - type: 'null'
          title: Username
        email:
          anyOf:
            - type: string
            - type: 'null'
          title: Email
        full_name:
          type: string
          title: Full Name
        tariff_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Tariff Name
        subscription_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Subscription Status
        traffic_limit_gb:
          type: number
          title: Traffic Limit Gb
        device_limit:
          type: integer
          title: Device Limit
        node_traffic:
          additionalProperties:
            type: integer
          type: object
          title: Node Traffic
        total_bytes:
          type: integer
          title: Total Bytes
      type: object
      required:
        - user_id
        - telegram_id
        - username
        - email
        - full_name
        - tariff_name
        - subscription_status
        - traffic_limit_gb
        - device_limit
        - node_traffic
        - total_bytes
      title: UserTrafficItem
    TrafficNodeInfo:
      properties:
        node_uuid:
          type: string
          title: Node Uuid
        node_name:
          type: string
          title: Node Name
        country_code:
          type: string
          title: Country Code
      type: object
      required:
        - node_uuid
        - node_name
        - country_code
      title: TrafficNodeInfo
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````