---
title: "List monitored channels"
method: GET
path: "/monitors"
tags: ["Monitoring"]
---

# List monitored channels

`GET /monitors`

## Request

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

Returns the channels this workspace monitors, with whether each one is on right now and the settings its clips use.

## Query parameters

- `page` number: Page number (default: 1)
- `limit` number: Items per page (default: 50, max: 100)
- `type` 'live' | 'video'

## Response `200`

Response for status 200

- object
  - `monitors` object[], required
    - `id` string, required
    - `type` 'live' | 'video', required
    - `platform` 'youtube' | 'twitch' | 'kick', required
    - `username` string, required
    - `display_name` string, nullable, required
    - `avatar_url` string, nullable, required
    - `enabled` boolean, required
    - `enabled_at` string, nullable, required: ISO 8601 timestamp of when the current monitoring period started; `null` while off. Stopping is refused for the first 10 minutes after it.
    - `strategy_id` string, required: Clipping strategy applied to every clip
    - `template_id` string, nullable, required: Edit template applied to every clip; `null` = none
    - `video_min_duration` number, nullable, required: `video` only: shorter uploads are skipped, in seconds
    - `video_max_duration` number, nullable, required: `video` only: longer uploads are skipped, in seconds
    - `days_of_week` number[], required: `video` only: days an upload is accepted, 0 = Sunday; empty = every day
    - `hours_of_day` array[], required: `video` only: `[from, to]` hour ranges an upload is accepted, in the workspace owner's timezone
      - number[]
  - `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

---

[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)