Retrieve Livestream
Retrieves a livestream by ID.
Authorizations
An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Headers
Pins the request to a dated API version.
"2026-10-15-1"
Path Parameters
Livestream ID, prefixed lfeed_.
Response
livestream found
When the livestream was created, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
When the livestream ended, as an ISO 8601 timestamp. null while it is live or before it starts.
"2026-01-01T12:00:00.000Z"
Livestream ID, prefixed lfeed_.
"lfeed_xxxxxxxxxxxxxxxxxxxxxx"
When a moderator pinned this livestream's recording, as an ISO 8601 timestamp. null when it is not pinned.
"2026-01-01T12:00:00.000Z"
When the recording's first frame was captured, as an ISO 8601 timestamp. Offsets into the recording count from here, not from started_at. null until recording starts.
"2026-01-01T12:00:00.000Z"
State of the recording. null when the livestream was not recorded.
recording, processing, completed, failed, null "completed"
A temporary link to the recording's video file. Retrieve the livestream again for a fresh link. null until the recording is ready, or when it was deleted.
"https://whop-livestreams-example.s3.amazonaws.com/room/lfeed_xxxxxxxxxxxxxxxxxxxxxx.mp4"
When the livestream went live, as an ISO 8601 timestamp. null before it starts.
"2026-01-01T12:00:00.000Z"
A temporary link to a still frame from the livestream. null when none was captured.
"https://img.whop.com/livestreams/lfeed_xxxxxxxxxxxxxxxxxxxxxx.jpg"
Display title of the livestream. Untitled Livestream when the host did not set one.
"Live edit: blue hour"

