---
title: "Get viewers from a live"
method: GET
path: "/live/{live_id}/viewers"
---

# Get viewers from a live

`GET /live/{live_id}/viewers`

Returns a real-time snapshot of viewer count and status for a live stream. Use this for 'watching now' counters. For viewer count over time, use the historic viewers endpoint.

## Path parameters

- `live_id` string, uuid, required

## Response `200`

Real-time viewer count and live stream status.

- object
  - `id` string, uuid — ID of the live stream.
  - `title` string — Title of the live stream.
  - `status` 'online' | 'offline' | 'canceled' | 'finished' | 'finished_imported' — Current status of the live.
  - `started_at` string, date-time, nullable — When the live started (ISO 8601), or null if not started yet.
  - `ended_at` string, date-time, nullable — When the live ended (ISO 8601), or null if still active.
  - `viewers` integer — Current number of concurrent viewers. 0 when the live is offline.

## Other responses

- `400` — 400

---

[API](https://skmtc.net/pandavideo/apis/api-v2.md) · [All operations](https://skmtc.net/pandavideo/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pandavideo/api-v2/versions/4fbd3c623ca9/schema)