---
title: List Live and Pre-made Streams API
updatedAt: 2026-04-02T15:34:35.000Z
---

Fetch the complete documentation index at: https://docs.watchers.io/llms.txt

# List Live and Pre-made Streams API

This API endpoint returns a list of rooms with status SOON or LIVE, created via the Room API or the admin panel. It provides details on each stream's current status, configuration, and metadata.

Results are sorted by `startTime` in ascending order (earliest first).

## **Endpoint URL**

> ⚠️ **Regional endpoints:** Replace `chatbackend.watchers.io` with the endpoint matching your project region. See [Supported Regions](https://docs.watchers.io/docs/supported-regions) for details.
> | Region | Endpoint |
> | :--- | :--- |
> | Europe (default) | `chatbackend.watchers.io` |
> | North America | `chatbackend.us.watchers.io` |
> | South America | `chatbackend.sa.watchers.io` |
> | Asia | `chatbackend.hk.watchers.io` |
> | Africa | `chatbackend.za.watchers.io` |

`https://chatbackend.watchers.io/room/premade?apiKey={API KEY}`

## **Authentication**

| Parameter | In    | Required | Description                          |
| --------- | ----- | -------- | ------------------------------------ |
| `apiKey`  | query | Yes      | API key of your project from the admin panel. |

## **Response Structure**

The API returns a JSON array of room objects. Each object contains the following fields:

| Field              | Type            | Description                                                                 |
| ------------------ | --------------- | --------------------------------------------------------------------------- |
| `id`               | number          | Internal room ID.                                                           |
| `externalRoomId`   | string          | Unique room ID provided at creation.                                        |
| `status`           | string          | Room status: `LIVE` or `SOON`.                                              |
| `name`             | string \| null  | Room name.                                                                  |
| `about`            | string \| null  | Room description.                                                           |
| `isSpeak`          | boolean         | Whether voice chat is enabled.                                              |
| `autoRecord`       | boolean         | Whether auto-recording is enabled.                                          |
| `pic`              | string \| null  | Room picture URL (original).                                                |
| `pic96`            | string \| null  | Room picture URL (96x96).                                                   |
| `pic128`           | string \| null  | Room picture URL (128x128).                                                 |
| `pic800`           | string \| null  | Room picture URL (800x800).                                                 |
| `startTime`        | string \| null  | Planned room start time (ISO 8601 UTC).                                     |
| `endTime`          | string \| null  | Planned room end time (ISO 8601 UTC).                                       |
| `createdAt`        | string          | Room creation timestamp (ISO 8601 UTC).                                     |
| `isSlowmode`       | boolean         | Whether slow mode is active.                                                |
| `slowmodeDelayMS`  | number          | Delay between messages in slow mode (milliseconds).                         |
| `record`           | string \| null  | URL of the room recording, if available.                                    |
| `streamUrl`        | string \| null  | External livestream URL.                                                    |
| `sourceUrl`        | string \| null  | Original stream source URL.                                                 |
| `embedUrl`         | string \| null  | Auto-generated embed URL (from `sourceUrl`). Supports YouTube, Twitch, Kick, Facebook, Vimeo. |
| `streamStartTime`  | string \| null  | Planned stream start time (ISO 8601 UTC).                                   |
| `streamEndTime`    | string \| null  | Planned stream end time (ISO 8601 UTC).                                     |
| `videoPosition`    | string \| null  | Video player position in the room layout (`OVER`, `UNDER`, or `null`).      |
| `eventDate`        | string \| null  | Event date associated with the room.                                        |
| `eventTitle`       | string \| null  | Event title associated with the room.                                       |
| `talkersCount`     | number          | Number of users who joined the room.                                        |
| `messagesCount`    | number          | Total number of messages in the room.                                       |

> The response may also contain additional internal fields not listed here. These are not part of the public API contract and should not be relied upon.

## **Example**

```bash
curl -s 'https://chatbackend.watchers.io/room/premade?apiKey=YOUR_API_KEY'
```

**Response:**

```json
[
  {
    "id": 1,
    "externalRoomId": "liveevent123",
    "status": "LIVE",
    "name": "Live Conference",
    "about": "Annual keynote",
    "isSpeak": true,
    "autoRecord": false,
    "pic": "https://cdn.example.com/room.jpeg",
    "pic96": "https://cdn.example.com/room-96.jpeg",
    "pic128": "https://cdn.example.com/room-128.jpeg",
    "pic800": "https://cdn.example.com/room-800.jpeg",
    "startTime": "2025-08-14T09:00:00.000Z",
    "endTime": "2025-08-14T10:00:00.000Z",
    "createdAt": "2025-08-13T12:00:00.000Z",
    "isSlowmode": false,
    "slowmodeDelayMS": 0,
    "record": null,
    "streamUrl": null,
    "sourceUrl": "https://www.youtube.com/watch?v=example",
    "embedUrl": "https://www.youtube.com/embed/example",
    "streamStartTime": null,
    "streamEndTime": null,
    "videoPosition": "OVER",
    "eventDate": null,
    "eventTitle": null,
    "talkersCount": 670,
    "messagesCount": 421
  }
]
```