# List lobbies

`GET /lobby.list`

## Description

Lists active lobbies in your account.

A lobby URL has the form `ro.am/{handle}` or `ro.am/{handle}/{slug}`.
- The "handle" is the first path segment
- The "slug" is the optional second path segment. It may be empty for the default lobby under a handle

Optionally filter by a specific lobby handle. If provided, only lobbies
associated with that handle are returned.

**Access:** Organization only.

**Required scope:** `lobby:read`

---

**OpenAPI Spec:** [chat.json](https://developer.ro.am/chat.json)

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Parameters

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `handle` | query | string | No | Filter by lobby handle (first path segment), e.g., `robfig` for `ro.am/robfig` or `ro.am/robfig/tour`.  |

## Responses

### 200 - OK

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `lobbies` | object[] | No |  |

**lobbies** (array item):

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | string | No | Unique identifier of the lobby configuration (UUID) |
| `slug` | string | No | Optional second path segment for the lobby. May be empty.  |
| `displayName` | string | No | Human-readable name of the lobby configuration |
| `active` | boolean | No | Whether the lobby configuration is active |
| `url` | string | No | Public URL of the lobby (e.g., `https://ro.am/handle` or `https://ro.am/handle/slug`) |
| `handle` | string | No | First path segment of the lobby URL  |


#### Example Response

```json
{
  "lobbies": [
    {
      "id": "6a2e0a6c-2a63-4a7d-9f2e-9b63f2a6c4b1",
      "slug": "",
      "displayName": "Default Lobby",
      "active": true,
      "url": "https://ro.am/person",
      "handle": "person"
    },
    {
      "id": "7b3c1d92-6d6f-4f23-9c2a-2a5f8e1d4c77",
      "slug": "tour",
      "displayName": "Tour Lobby",
      "active": true,
      "url": "https://ro.am/person/tour",
      "handle": "person"
    }
  ]
}
```

### 400 - Bad request.

### 401 - Presented invalid authentication credentials.

### 404 - Handle not found.

### 405 - An unsupported method was requested.

### 500 - An internal error occured.

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/chat-api/lobby-list*