---
title: "List lives"
method: GET
path: "/"
---

# List lives

`GET /`

## Request

- Base URL: `https://api-v2.pandavideo.com.br/lives`
- URL: `https://api-v2.pandavideo.com.br/lives/`
- Auth: API key in header `Authorization`

Lists the lives in your account, 100 per page. On a normal account the response is a plain list; on a trial account it becomes an object with lives and trial_limit_reached. The item of the list is smaller than the response of the create.

## Query parameters

- `page` integer
- `limit` integer
- `status` 'online' | 'offline' | 'canceled' | 'finished' | 'finished_imported'

## Response `200`

List of lives wrapped in a paginated object. NOTE: legacy formats (raw array or 'lives' key) may also be returned in some cases — the canonical shape is documented here.

- object[]: Plain list of lives. On trial accounts the response is an object instead: { lives: [...], trial_limit_reached: true }.
  - `id` string
  - `title` string
  - `status` 'provisioning' | 'offline' | 'online' | 'finishing' | 'finished' | 'finished_imported' | 'expired' | 'canceled': Current status of the live.
  - `stream_key_id` string
  - `stream_key` string: Stream key value used by the encoder.
  - `user_id` string
  - `region` 'us' | 'br': Ingest region of this live: `us` or `br`.
  - `quality_package` string: Derived from `bitrate`, not the value stored at creation - it may not match what was requested.
  - `save_vod` boolean: Whether this live is being recorded.
  - `bitrate` object[]
  - `active_dvr` boolean
  - `folder_id` unknown
  - `rtmp` string: Ingest server without the key. Prefer `ingest_endpoint`.
  - `live_hls` string: Legacy playback URL. Prefer `playback_url`.
  - `live_player` string: Embeddable player URL for the live.
  - `scheduled_at` unknown
  - `started_at` unknown
  - `ended_at` unknown
  - `vod_id` unknown
  - `video_id` string, nullable: Video created from the recording, once ready.
  - `created_at` string
  - `video_height` integer: Height of the recorded video. Present once the recording became a video.
  - `video_width` integer: Width of the recorded video. Present once the recording became a video.
  - `signal` object, nullable: Real-time signal health of the live stream. Present when the live is online; null otherwise. Contains the current state, metrics, alerts and a timeline of events.
    - `state` 'waiting' | 'ok' | 'lost' | 'no_av' | 'no_image' | 'zero_bitrate' | 'zero_fps' | 'no_audio' | 'unstable' | 'low_bitrate' | 'low_fps' | 'null', nullable: Current signal state. `ok` = healthy, `waiting` = no signal yet, others indicate specific problems.
    - `kind` 'card' | 'flag' | 'null', nullable: How the alert is displayed in the dashboard: `card` (prominent) or `flag` (subtle).
    - `since` string, nullable: ISO 8601 timestamp of when the current state started.
    - `auto_stop_at` string, nullable: ISO 8601 timestamp when the live will be automatically stopped if the problem persists. Null when healthy.
    - `current` object, nullable: Current ingest metrics at the moment of the response.
      - `bitrate_kbps` number, nullable: Current bitrate in kbps.
      - `fps` number, nullable: Current frames per second.
      - `audio_dbfs` number, nullable: Current audio level in dBFS.
    - `trigger` object, nullable: Metrics that triggered the current alert state. Same shape as `current`.
      - `bitrate_kbps` number, nullable
      - `fps` number, nullable
      - `audio_dbfs` number, nullable
    - `recommended` object, nullable: Recommended ingest settings for optimal quality.
      - `bitrate_kbps` number: Recommended bitrate in kbps.
      - `min_fps` number: Minimum acceptable frame rate.
      - `ideal_fps` number: Ideal frame rate for best quality.
    - `connected_since` string, nullable: ISO 8601 timestamp of when the encoder connected.
    - `open_alerts` string[]: List of currently active alert codes (e.g. `low_bitrate`, `no_audio`).
    - `events` object[]: Timeline of signal events during the broadcast. Each entry records a state change.
      - `code` 'received' | 'lost' | 'restored' | 'unstable' | 'normalized' | 'low_fps' | 'low_bitrate' | 'no_image' | 'no_audio' | 'no_av' | 'zero_fps' | 'zero_bitrate' | 'resolved': Event code describing the state change.
      - `at` string: ISO 8601 timestamp of when the event occurred.
    - `server_time` string, nullable: Server time when this signal snapshot was produced.

## Other responses

- `500`: 500

---

[API](https://skmtc.dev/pandavideo/apis/live-v2.md) - [All operations](https://skmtc.dev/pandavideo/apis/live-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/pandavideo/apis/live-v2/revisions/2ca63304ecc0?raw)