---
title: "Get play events for live stream"
method: GET
path: "/analytics/live-streams/plays"
tags: ["Analytics"]
---

# Get play events for live stream

`GET /analytics/live-streams/plays`

Retrieve filtered analytics about the number of plays for your live streams in a project.

## Query parameters

- `from` string, date, required
- `to` string, date
- `dimension` 'liveStreamId' | 'emittedAt' | 'country' | 'deviceType' | 'operatingSystem' | 'browser', required
- `filter` string
- `currentPage` integer
- `pageSize` integer

## Response `200`

Success

- AnalyticsPlaysResponse
  - `data` AnalyticsData[], required
    - `value` string, required — Shows a value for the property you have specified for `dimension` in your request. For example, if you requested `dimension=videoId`, each `value` field in the response returns a different videoId.
    - `plays` integer, required — Shows the number of play events for one specific `value`.
  - `pagination` Pagination, required
    - `itemsTotal` integer — Total number of items that exist.
    - `pagesTotal` integer — Number of items listed in the current page.
    - `pageSize` integer — Maximum number of item per page.
    - `currentPage` integer — The current page index.
    - `currentPageItems` integer — The number of items on the current page.
    - `links` PaginationLink[], required
      - `rel` string
      - `uri` string, uri

## Other responses

- `400` — Bad request error
- `403` — Forbidden - Disabled Analytics
- `404` — Not Found
- `429` — Too Many Requests

## Changes

- **2024-04-16** `ec2b79bfdc8d` — 1 info
  - added the non-success response with the status `429`
- **2023-06-27** `6496aa462404` — 1 info
  - added the non-success response with the status `403`
- **2023-06-21** `64665da540fd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/apivideo/apis/api-video/changes/analytics/live-streams/plays/get.md)

---

[API](https://skmtc.dev/apivideo/apis/api-video.md) · [All operations](https://skmtc.dev/apivideo/apis/api-video/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apivideo/api-video/revisions/ec2b79bfdc8d/schema)