Get Stream Status
Retrieve the current status of a stream, including source details and the state and URLs of every output.
GET
Overview
Returns the current state of a stream. The response shape is the same whether the stream is scheduled, live, or finished, which makes it suitable for dashboards and polling loops. Use it to:- Track the stream through its lifecycle (
scheduled→setting up→started→ended). - Read the playback URLs of Camb.ai-hosted outputs (SRT listener, HLS recording).
- Check per-target delivery state and surface errors.
Reading the response
status- the stream lifecycle status:1scheduled,2setting up,3started,4ended,5interrupted,6error.targets[].state- each output progressesscheduled→active→completed, orfailedon error.targets[].playback_url- set for Camb.ai-hosted outputs; this is where you or your viewers connect.targets[].destination_url- set for push outputs; the endpoint Camb.ai is delivering to.error- populated whenstatusis6.
Errors
404- No stream with this ID belongs to your team.422- Invalidstream_id.
Related endpoints
Authorizations
Response
Current state of the stream.
Current state of a stream. The shape is identical whether the stream is scheduled, live, or finished.
Last modified on July 24, 2026