---
title: "List live events"
method: GET
path: "/v2/sites/{site_id}/channels/{channel_id}/events/"
tags: ["live events"]
---

# List live events

`GET /v2/sites/{site_id}/channels/{channel_id}/events/`

## Request

- Base URL: `https://api.jwplayer.com`
- URL: `https://api.jwplayer.com/v2/sites/{site_id}/channels/{channel_id}/events/`
- Auth: API key in header `Authorization`

Get a list of events that belong to a live channel

## Path parameters

- `site_id` string, required: Unique identifier for a resource
- `channel_id` string, required: Unique identifier for a resource

## Query parameters

- `page` integer
- `page_length` integer
- `q` string
- `sort` string

## Response `200`

Resources successfully retrieved

- LiveChannelEventResourcesRead
  - `page` integer: Offset for returned resources
  - `page_length` integer: Maximum number of resources to return
  - `total` integer: Number of resources available before pagination
  - `events` LiveChannelEventResourceRead[]
    - `schema` string
    - `id` string: Unique identifier for a resource
    - `created` string: Date and time at which the resource was created
    - `last_modified` string: Date and time at which the resource was most recently modified
    - `type` string: Name of the type of resource.
    - `relationships` object: Ancilliary resources associated to the primary resource being read
    - `master_access` object
      - `status` 'unavailable' | 'requested' | 'available'
      - `expiration` string, date-time, nullable: Shows the ultimate date and time that the master can be downloaded before access needs to be requested again. When access is not available, `null` is returned
    - `media_id` string: Unique identifier for a resource
    - `metadata` object
    - `status` 'active' | 'completed' | 'idle' | 'errored'

## Other responses

- `400`: Invalid JSON request body
- `404`: Resource with ID supplied does not exist in account and object namespace

## Changes

- **2026-11-03** `9fad6bd5872e`: 2 info
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `404`

[Operation history](https://skmtc.dev/jwplayer/apis/management-api-v2/changes/v2/sites/:site_id/channels/:channel_id/events/get.md)

---

[API](https://skmtc.dev/jwplayer/apis/management-api-v2.md) - [All operations](https://skmtc.dev/jwplayer/apis/management-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/jwplayer/apis/management-api-v2/revisions/9fad6bd5872e?raw)