---
title: "Get Live Embed Sessions"
method: GET
path: "/embed/sessions/{embedId}/live"
tags: ["Media Embed"]
---

# Get Live Embed Sessions

`GET /embed/sessions/{embedId}/live`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/embed/sessions/{embedId}/live`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

How many people are on one embed right now: sessions active in the last minute, sessions still open but idle, and the time of the most recent activity. Legacy visits are never counted. Members without access to all folders only see embeds for media and folders they can open. Any other embed, or an embed that is deleted or in another workspace, returns 404.

## Path parameters

- `embedId` string, required

## Query parameters

- `traffic` 'all' | 'people' | 'bots'
- `includeOwner` boolean

## Response `200`

OK

- object
  - `status` 'success'
  - `data` object
    - `liveNow` integer: Open sessions with activity in the last minute.
    - `idleOpen` integer: Open sessions with no activity in the last minute whose page is still open.
    - `lastActivityAt` string, date-time, nullable: Most recent activity on the embed. Null when there has been none.

## Other responses

- `400`: A query parameter failed validation
- `404`: Embed not found

## Changes

- **2026-10-19** `52d777e6d46e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/speakai/apis/speak-ai-api/changes/embed/sessions/:embedId/live/get.md)

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)