---
title: "Show information about all rooms"
method: GET
path: "/room"
tags: ["room"]
---

# Show information about all rooms

`GET /room`

## Response `200`

Success

- RoomsListingResponse — Response containing list of all rooms
  - `data` Room[], required
    - `components` Component[], required
      - `id` string, required — Assigned component id
      - `type` string, required — Component type
    - `config` RoomConfig, required — Room configuration
      - `maxPeers` integer, nullable — Maximum amount of peers allowed into the room
      - `videoCodec` 'h264' | 'vp8', nullable — Enforces video codec for each peer in the room
    - `id` string, required — Room ID
    - `peers` Peer[], required
      - `id` string, required — Assigned peer id
      - `status` 'connected' | 'disconnected', required — Informs about the peer status
      - `type` string, required — Peer type

## Other responses

- `401` — Unauthorized

## Changes

- **2023-07-18** `dafa9a249254` — 2 breaking, 4 warning, 6 info
  - removed the required property `data/items/peers/items/metadata` from the response with the `200` status
  - removed the required property `data/items/peers/items/tracks` from the response with the `200` status
  - removed the optional property `data/items/config/peerDisconnectedTimeout` from the response with the `200` status
  - removed the optional property `data/items/config/peerlessPurgeTimeout` from the response with the `200` status
  - …8 more

[Change history](https://skmtc.dev/fishjam-dev/apis/fishjam-media-server/changes/room/get.md)

---

[API](https://skmtc.dev/fishjam-dev/apis/fishjam-media-server.md) · [All operations](https://skmtc.dev/fishjam-dev/apis/fishjam-media-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fishjam-dev/fishjam-media-server/revisions/dafa9a249254/schema)