List lives

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.

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

Query parameters

pageinteger

Page number for pagination. Defaults to 1.

limitinteger

Page size (lives per page). Defaults to 100.

status'online' | 'offline' | 'canceled' | 'finished' | 'finished_imported'

Optional filter by live status.

Response

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.

idstring
titlestring
status'provisioning' | 'offline' | 'online' | 'finishing' | 'finished' | 'finished_imported' | 'expired' | 'canceled'

Current status of the live.

stream_key_idstring
stream_keystring

Stream key value used by the encoder.

user_idstring
region'us' | 'br'

Ingest region of this live: us or br.

quality_packagestring

Derived from bitrate, not the value stored at creation - it may not match what was requested.

save_vodboolean

Whether this live is being recorded.

bitrateobject[]
active_dvrboolean
folder_idunknown
rtmpstring

Ingest server without the key. Prefer ingest_endpoint.

live_hlsstring

Legacy playback URL. Prefer playback_url.

live_playerstring

Embeddable player URL for the live.

scheduled_atunknown
started_atunknown
ended_atunknown
vod_idunknown
video_idstring nullable

Video created from the recording, once ready.

created_atstring
video_heightinteger

Height of the recorded video. Present once the recording became a video.

video_widthinteger

Width of the recorded video. Present once the recording became a video.

Example response

[
  {
    "id": "X",
    "title": "X",
    "status": "finished_imported",
    "stream_key_id": "X",
    "stream_key": "f58b18a0-9eea-4cf8-bcb6-b4b8d6cd9a80",
    "user_id": "X",
    "region": "us",
    "quality_package": "hd",
    "save_vod": true,
    "active_dvr": true,
    "rtmp": "rtmp://vz-{hash}.us.pandavideo.live/live",
    "live_hls": "https://b-vz-{hash}.tv.pandavideo.com.br/{live_id}/playlist.m3u8.live",
    "live_player": "https://player-vz-{hash}.tv.pandavideo.com.br/embed/live/?v={live_id}",
    "created_at": "X"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.