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

# Get live

`GET /{live_id}`

## Request

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

This endpoint returns detailed information about a specific live stream registered on the Panda Video platform. It allows you to monitor the status of the broadcast in real time or retrieve comprehensive data after the live session has ended.  The response includes data such as the title, status, start and end times, playback URLs (HLS and embed player), as well as streaming credentials (RTMP and stream key). You’ll also receive information about the generated VOD, view metrics, video resolution, and additional settings such as DVR and latency type.  This endpoint is especially useful for tracking the live stream lifecycle, displaying relevant data on your application’s front end, or integrating with systems that need to follow the full journey of a live — from scheduling to the final recorded content.

## Path parameters

- `live_id` string, required

## Response `200`

200

- object
  - `id` string
  - `title` string
  - `rtmp` string
  - `stream_key` string
  - `stream_key_id` string
  - `user_id` string
  - `started_at` unknown
  - `ended_at` unknown
  - `vod_id` unknown
  - `video_id` string
  - `status` string
  - `view_metrics` object
  - `live_player` string
  - `live_hls` string
  - `scheduled_at` string
  - `active_dvr` boolean
  - `config` object
  - `folder_id` unknown
  - `created_at` unknown
  - `chat_id` string
  - `chat_status` string
  - `latency_type` string
  - `video_height` unknown
  - `video_width` unknown
  - `region` 'us' | 'br', nullable: Ingest region of this live: `us` or `br`.
  - `quality_package` string, nullable: Quality ladder applied to this live (`sd`, `hd`, `fhd`, `4k`).
  - `save_vod` boolean: Whether this live is being recorded.
  - `ingest_endpoint` string, nullable: Full RTMP ingest URL including the stream key. Null until provisioned.
  - `ingest_hostname` string, nullable: Ingest server hostname specific to your account. Null until provisioned.
  - `playback_url` string, nullable: Playback URL for the live. Null until the live is ready.
  - `current_time` string: Server time when the response was produced (ISO 8601).
  - `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

- `404`: 404
- `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)