Get live

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
ParameterTypeDescription
live_idstringUnique identifier of the live stream, used to retrieve data for a specific broadcast.

Response Fields

FieldTypeDescription
idstringUnique identifier of the live stream.
titlestringTitle of the live stream.
rtmpstring | nullLegacy RTMP ingest server (without the stream key). Prefer ingest_endpoint. Null on newer lives.
stream_keystringStream key value used by the encoder.
stream_key_idstringID of the stream key attached to this live.
user_idstringID of the user who owns the live.
started_atstring | nullISO 8601 timestamp of when the broadcast started. Null if not yet started.
ended_atstring | nullISO 8601 timestamp of when the broadcast ended. Null if still running or not started.
vod_idstring | nullID of the VOD (recorded video) generated after the live ends. Null until ready.
video_idstring | nullID of the video created from the recording. Null until ready.
statusstringCurrent status of the live: provisioning, offline, online, finishing, finished, finished_imported, expired, or canceled.
view_metricsobjectAudience metrics of the live (empty object {} when no data).
live_playerstringEmbeddable player URL for the live stream.
live_hlsstringHLS playback URL for the live stream.
bitratestring[] | nullVideo qualities enabled for adaptive playback (e.g. ["360p", "480p", "720p"]).
scheduled_atstring | nullScheduled start time (ISO 8601). Null if not scheduled.
active_dvrbooleanWhether DVR (rewind during broadcast) is enabled.
configobjectInternal settings of the live.
folder_idstring | nullFolder where the recorded video is stored. Null if none.
created_atstringISO 8601 timestamp of when the live was created.
chat_idstring | nullID of the chat room attached to the live.
chat_statusstring | nullStatus of the live chat: active or inactive.
latency_typestringLatency profile: low (5-7s), default (15-20s), or high (60-70s).
regionstringIngest region: us or br.
quality_packagestring | nullQuality ladder applied to this live: sd, hd, fhd, or 4k.
save_vodbooleanWhether this live is being recorded as a VOD.
ingest_endpointstring | nullFull RTMP ingest URL including the stream key. Null until provisioned.
ingest_hostnamestring | nullIngest server hostname specific to your account. Null until provisioned.
playback_urlstring | nullPlayback URL for the live. Null until the live is ready.
current_timestringServer time when the response was produced (ISO 8601).
video_heightinteger | nullHeight of the recorded video in pixels. Present once the recording became a video.
video_widthinteger | nullWidth of the recorded video in pixels. Present once the recording became a video.
signalobject | nullReal-time signal health data. Present when online; null otherwise. See below.

Signal Object

The signal field contains real-time signal health data for the live stream. It is present (non-null) only while the live status is online; for all other statuses it returns null.

This is the same data that powers the alerts and timeline shown in the dashboard metrics tab. There is no separate endpoint for signal data — it all comes from this endpoint.

FieldTypeDescription
signal.statestring | nullCurrent signal state. See table below for all possible values.
signal.kindstring | nullHow the alert is displayed: card (prominent) or flag (subtle).
signal.sincestring | nullISO 8601 timestamp of when the current state started.
signal.auto_stop_atstring | nullWhen the live will be automatically stopped if the problem persists. Null when healthy.
signal.currentobject | nullCurrent ingest metrics: bitrate_kbps, fps, audio_dbfs.
signal.triggerobject | nullMetrics that triggered the current alert. Same shape as current.
signal.recommendedobject | nullRecommended settings: bitrate_kbps, min_fps, ideal_fps.
signal.connected_sincestring | nullWhen the encoder connected.
signal.open_alertsstring[]List of currently active alert codes (e.g. low_bitrate, no_audio).
signal.eventsobject[]Timeline of signal events during the broadcast. Each entry has code and at.
signal.server_timestring | nullServer time when this signal snapshot was produced.

Signal States

StateMeaning
waitingLive is online but no signal received yet.
okSignal is healthy.
lostSignal was lost completely.
no_avNo audio and no video detected.
no_imageNo video frames detected (audio may still be present).
zero_bitrateBitrate dropped to zero.
zero_fpsFrame rate dropped to zero.
no_audioNo audio detected (video is still present).
unstableSignal is fluctuating.
low_bitrateBitrate is below the recommended threshold.
low_fpsFrame rate is below the recommended threshold.

Signal Event Codes (Timeline)

The signal.events array records every state change during the broadcast, forming a timeline of what happened.

CodeMeaning
receivedEncoder signal was received (stream started).
lostSignal was lost.
restoredSignal was restored after being lost.
unstableSignal became unstable.
normalizedSignal returned to normal after being unstable.
low_fpsFrame rate dropped below threshold.
low_bitrateBitrate dropped below threshold.
no_imageVideo frames stopped arriving.
no_audioAudio stopped arriving.
no_avBoth audio and video stopped.
zero_fpsFrame rate reached zero.
zero_bitrateBitrate reached zero.
resolvedA previously reported problem was resolved.
Path Params
string
required
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json