---
title: "List broadcasts of a live monitor"
method: GET
path: "/monitors/{id}/broadcasts"
tags: ["Monitoring"]
---

# List broadcasts of a live monitor

`GET /monitors/{id}/broadcasts`

## Request

- Base URL: `https://api.cut.pro/api/v1`
- URL: `https://api.cut.pro/api/v1/monitors/{id}/broadcasts`
- Auth: API key in header `X-Api-Key`

Returns the channel's broadcasts, newest first, each with how many clips this workspace got from it. A broadcast with `ended_at: null` is on air and keeps producing clips every 10 minutes while the monitor is on. Only `live` monitors have broadcasts: a `video` monitor answers `400 INVALID_OBSERVING_TYPE`, and its clips arrive as regular submissions in `GET /clips`.

## Path parameters

- `id` string, required

## Query parameters

- `page` number: Page number (default: 1)
- `limit` number: Items per page (default: 20, max: 100)

## Response `200`

Response for status 200

- object
  - `broadcasts` object[], required
    - `id` string, required: The platform's own id for the broadcast
    - `title` string, required
    - `category` string, required: Game or category the channel set for the broadcast; empty when none
    - `language` string, required
    - `is_mature` boolean, required
    - `tags` string[], required
    - `started_at` string, required: ISO 8601 timestamp of when the broadcast went on air
    - `ended_at` string, nullable, required: ISO 8601 timestamp of when it went off air; `null` while it is still live
    - `clips_count` number, required: Clips this workspace got from the broadcast
    - `thumbnail_url` string, nullable, required
    - `recording_expired` boolean, required: `true` once the recording was purged: its clips can no longer be listed or rendered
  - `pagination` object, required
    - `current_page` number, required: Current page number (1-based)
    - `total_pages` number, required: Total number of pages
    - `total_count` number, required: Total number of items across all pages
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `limit` number, required: Items per page used for this response

## Other responses

- `400`: Response for status 400
- `404`: Response for status 404

---

[API](https://skmtc.dev/cut/apis/cutpro-api.md) · [All operations](https://skmtc.dev/cut/apis/cutpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cut/apis/cutpro-api/revisions/89d0bafe529c?raw)