---
title: "Handler for GET /livekit/rooms endpoint"
method: GET
path: "/livekit/rooms"
tags: ["livekit"]
---

# Handler for GET /livekit/rooms endpoint

`GET /livekit/rooms`

Lists all LiveKit rooms belonging to the authenticated client.
Rooms are filtered by `metadata.auth_id` for tenant isolation.

# Arguments
* `state` - Shared application state containing LiveKit configuration
* `auth` - Authentication context from middleware

# Returns
* `Response` - JSON response with rooms list or error status

# Filtering
- When `auth.id` is present: Returns only rooms where `metadata.auth_id == auth.id`
- When `auth.id` is absent: Returns all rooms (backward-compatible mode)

# Errors
* 500 Internal Server Error - LiveKit service not configured or API call failed

## Response `200`

Rooms listed successfully

- ListRoomsResponse — Response containing the list of LiveKit rooms # Example ```json { "rooms": [ { "name": "room-1", "num_participants": 2, "creation_time": 1703123456 }, { "name": "room-2", "num_participants": 0, "creation_time": 1703123789 } ] } ```
  - `rooms` RoomInfo[], required — List of rooms belonging to the authenticated client (filtered by metadata.auth_id)
    - `creation_time` integer, required — Room creation time (Unix timestamp in seconds)
    - `name` string, required — The room name
    - `num_participants` integer, required — Number of current participants in the room

## Other responses

- `500` — LiveKit service not configured or failed to list rooms

## Changes

- **2026-02-08** `0df166d28191` — 2 info
  - the endpoint scheme security `auth` was added to the API
  - the endpoint scheme security `bearer_auth` was removed from the API
- **2025-12-30** `3dea279a6ec1` — 1 info
  - endpoint added
- **2025-11-12** `d85b83f25aea` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/saynaai/apis/sayna-api/changes/livekit/rooms/get.md)

---

[API](https://skmtc.dev/saynaai/apis/sayna-api.md) · [All operations](https://skmtc.dev/saynaai/apis/sayna-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/saynaai/sayna-api/revisions/395ce7e35139/schema)