---
title: "Get YouTube live status"
method: GET
path: "/v1/social/youtube/{accountId}/live"
tags: ["social"]
---

# Get YouTube live status

`GET /v1/social/youtube/{accountId}/live`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/social/youtube/{accountId}/live`
- Auth: none required

Check whether a connected YouTube channel is currently live streaming, identified by accountId. The response includes the current viewer count when the channel is live.

**Notes.**
- No `stale` field: a failure reads as not live.

## Path parameters

- `accountId` string, required

## Query parameters

- `dt` string, required

## Response `200`

Success.

- object
  - `data` object, required
    - `isLive` boolean, required
    - `videoId` string, nullable, required
    - `concurrentViewers` integer, nullable, required

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `404`: No such account, or the `dt` token is missing, expired or for another workspace.
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/02fd3665dc7d?raw)