---
title: "Get game rooms"
method: GET
path: "/rooms"
---

# Get game rooms

`GET /rooms`

Returns recent game rooms with optional time filter

## Query parameters

- `hours` integer
- `limit` integer

## Response `200`

Successful response

- object
  - `hours` integer — Hours filter applied
  - `limit` integer — Limit applied
  - `count` integer — Number of rooms returned
  - `rooms` object[]
    - `description` string — Room description
    - `status` integer — Room status (0=preparing, 1=public, 2=private, 3=busy, 4=closed, 5=abandoned)
    - `playerLimit` integer — Maximum number of players
    - `version` string — Game version
    - `ageSeconds` integer — Seconds since room creation
    - `createdAt` string, date-time — Room creation timestamp
    - `mods` object — JSON object containing mod configuration

## Changes

- **2026-07-17** `4cf7570c4d14` — 1 warning, 1 info
  - removed the optional property `rooms/items/secondsElapsed` from the response with the `200` status
  - added the optional property `rooms/items/ageSeconds` to the response with the `200` status
- **2026-01-18** `85c3cc76a3ee` — 1 info
  - added the optional property `rooms/items/createdAt` to the response with the `200` status
- **2026-01-18** `ed66f1aeead4` — 1 info
  - endpoint added
- **2026-01-17** `7789f1b77ffb` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/vcmi/apis/vcmi-lobby-api/changes/rooms/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)