Skip to content
StreamElements Docs

Stream Status

Topic
channel.stream.status
Scope
stream-live:read

The channel.stream.status topic provides real-time updates about whether a channel is currently live streaming or offline. Subscribe to this topic to receive updates whenever a channel’s streaming status changes.

Payload

Section titled “Payload”

isLive is the payload’s only field — the message carries no stream ID, title, or game. If the channel streams on several platforms at once, it stays true as long as at least one stream is live.

Parameter Type Description
data.isLive boolean Whether the channel is currently live

Example

Section titled “Example”

Going live:

{
    "id": "01HPPM2TQ6CCMFQGHENAPFR4ZE",
    "ts": "2024-02-15T14:52:42Z",
    "type": "message",
    "topic": "channel.stream.status",
    "data": {
        "isLive": true
    }
}

Going offline:

{
    "id": "01HPPM61Y1V0Q4XRQ9E4H0YB7D",
    "ts": "2024-02-15T18:03:11Z",
    "type": "message",
    "topic": "channel.stream.status",
    "data": {
        "isLive": false
    }
}
Section titled “Related”