---
title: "Get Top Users"
method: GET
path: "/menu-layout/stats/top-users"
tags: ["menu-layout"]
---

# Get Top Users

`GET /menu-layout/stats/top-users`

## Request

- The document declares no server URL.
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/docs/menu-layout/stats/top-users/get.ts> (a function with typed inputs; its response is checked against the schema)

Получить топ пользователей по количеству кликов.

## Query parameters

- `button_id` string, nullable
- `limit` integer
- `days` integer

## Response `200`

Successful Response

- TopUsersResponse: Топ пользователей по кликам.
  - `items` TopUserStats[], required
    - `user_id` integer, required
    - `clicks_count` integer, required
    - `last_click_at` string, date-time, nullable
  - `button_id` string, nullable
  - `limit` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `2360876ff9c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/changes/menu-layout/stats/top-users/get.md)

---

[API](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api.md) - [All operations](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/revisions/2360876ff9c5?raw)