---
title: "Get lobby statistics"
method: GET
path: "/stats"
---

# Get lobby statistics

`GET /stats`

Returns comprehensive statistics about the VCMI lobby including online players, registered players, games, and lobbies

## Response `200`

Successful response

- object
  - `onlinePlayers` string[] — List of currently online player display names
  - `onlinePlayersCount` object
    - `current` integer — Currently online players
    - `lastHour` integer — Active in last hour
    - `lastDay` integer — Active in last 24 hours
    - `lastWeek` integer — Active in last week
    - `lastMonth` integer — Active in last month
    - `lastYear` integer — Active in last year
  - `registeredPlayersCount` object
    - `total` integer — Total registered players
    - `lastDay` integer — Registered in last 24 hours
    - `lastWeek` integer — Registered in last week
    - `lastMonth` integer — Registered in last month
    - `lastYear` integer — Registered in last year
  - `gameCount` object
    - `current` integer — Currently running games
    - `total` integer — Total completed games
    - `lastDay` integer — Games in last 24 hours
    - `lastWeek` integer — Games in last week
    - `lastMonth` integer — Games in last month
    - `lastYear` integer — Games in last year
  - `lobbyCount` object
    - `current` integer — Currently open lobbies
    - `public` integer — Public lobbies
    - `private` integer — Private lobbies
  - `lobbyStartTime` string, date-time — Server start timestamp
  - `server` string — Server name
  - `apiVersion` string — API version

## Changes

> 6 revisions in range; 1 could not be searched.

- **2026-03-23** `017ca8cb2344` — 1 warning
  - removed the optional property `lobbyVersion` from the response with the `200` status
- **2026-01-17** `7789f1b77ffb` — 1 info
  - added the optional property `lobbyVersion` to the response with the `200` status

[Change history](https://skmtc.dev/vcmi/apis/vcmi-lobby-api/changes/stats/get.md)

---

[API](https://skmtc.dev/vcmi/apis/vcmi-lobby-api.md) · [All operations](https://skmtc.dev/vcmi/apis/vcmi-lobby-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vcmi/vcmi-lobby-api/revisions/4cf7570c4d14/schema)