---
title: "Get live event session stats"
method: POST
path: "/public/get-live-event-session-stats"
tags: ["Live"]
---

# Get live event session stats

`POST /public/get-live-event-session-stats`

Get stream and viewer stats for a live event session

Authentication with the "FERMION-API-KEY" header is required to use this endpoint.

Rate limit: Maximum 60 requests in a window of 1m.

## Request body

- object
  - `data` object[], required
    - `data` object, required
      - `liveEventSessionId` string, required — ID of liveEventSession - You will find this in your dashboard
      - `topUserCount` number, required — Number of top users (by watch time) to be returned in the response

## Response `200`

API Response Body

- object[]
  - `output` union, required
    - object
      - `status` 'ok', required
      - `data` object, required
        - `estimatedStreamDurationInMinutes` number, required
        - `streamStartedAt` string, date-time, required
        - `streamEndedAt` union, required
          - string, date-time
          - unknown
          - unknown
        - `totalMessagesSentCount` number, required
        - `instructorMessagesSentCount` number, required
        - `pollsConductedCount` number, required
        - `uniqueUsersCount` number, required
        - `currentActivelyWatchingDistinctUserCount` number, required
        - `peakConcurrentUsers` number, required
        - `streamSegmentData` object[], required
          - `startAtIso` string, required
          - `endAtIso` string, required
          - `activelyWatchingDistinctUserCount` number, required
        - `topUsersByWatchTime` object[], required
          - `fermionInternalUserId` string, required — This is fermion's internal unique ID for a user
          - `userId` union, required
            - string — This is a string that you have stored in your database that can uniquely identify a given user. This is the same as the ID that you provided if you added a participant with the API.
            - unknown
            - unknown
          - `email` union, required
            - string, email
            - unknown
            - unknown
          - `name` string, required
          - `username` string, required
          - `profilePicUrl` string, uri, required
          - `segmentsWatchedCount` number, required
          - `firstSeenAt` string, date-time, required — The timestamp when the user first started watching the stream.
          - `lastSeenAt` string, date-time, required — The timestamp when the user was watching the stream for the last time.
    - object
      - `status` 'error', required
      - `errorMessage` string, required

---

[API](https://skmtc.net/fermion/apis/fermion-backend-api.md) · [All operations](https://skmtc.net/fermion/apis/fermion-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fermion/fermion-backend-api/revisions/7ce364c8820b/schema)