---
title: "Get Top Referrers"
method: GET
path: "/cabinet/admin/stats/referrals/top"
tags: ["Cabinet Admin Stats"]
---

# Get Top Referrers

`GET /cabinet/admin/stats/referrals/top`

Get top referrers with earnings breakdown by period.

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- AppCabinetRoutesAdminStatsTopReferrersResponse — Top referrers response.
  - `by_earnings` AppCabinetRoutesAdminStatsTopReferrerItem[], required
    - `user_id` integer, required
    - `telegram_id` integer, nullable
    - `email` string, nullable
    - `username` string, nullable
    - `display_name` string, required
    - `invited_count` integer, required
    - `invited_today` integer
    - `invited_week` integer
    - `invited_month` integer
    - `earnings_today_kopeks` integer
    - `earnings_week_kopeks` integer
    - `earnings_month_kopeks` integer
    - `earnings_total_kopeks` integer
  - `by_invited` AppCabinetRoutesAdminStatsTopReferrerItem[], required
    - `user_id` integer, required
    - `telegram_id` integer, nullable
    - `email` string, nullable
    - `username` string, nullable
    - `display_name` string, required
    - `invited_count` integer, required
    - `invited_today` integer
    - `invited_week` integer
    - `invited_month` integer
    - `earnings_today_kopeks` integer
    - `earnings_week_kopeks` integer
    - `earnings_month_kopeks` integer
    - `earnings_total_kopeks` integer
  - `total_referrers` integer, required
  - `total_referrals` integer, required
  - `total_earnings_kopeks` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/bedolagam/apis/remnawave-bot-admin-api.md) · [All operations](https://skmtc.net/bedolagam/apis/remnawave-bot-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bedolagam/remnawave-bot-admin-api/revisions/45956d1b13ec/schema)