---
title: "Get all channels"
method: GET
path: "/channels"
tags: ["Channels"]
---

# Get all channels

`GET /channels`

## Query parameters

- `externalId` string — Filter by external ID. Matches channels where any entry of 'externalIds' equals the value.
- `cursor` string — Pagination cursor
- `limit` number, nullable — Maximum number of channels to return (max 100)
- `name` string — Filter by channel name
- `search` string — Search channels based on ID or name
- `status` string — Comma-separated list of statuses to filter by
- `id` string — Filter by channel ID

## Response `200`

List of channels

- PaginatedChannelResult
  - `data` Channel[], required — List of channels
    - `id` string, required — Unique identifier of the channel
    - `createdAt` string, required — Creation timestamp
    - `name` string, required — Name of the channel
    - `status` 'ready' | 'stopped' | 'deploying' | 'starting' | 'waiting' | 'ingesting' | 'playing' | 'stopping' | 'error' | 'deleting' | 'deleted', required — Current status of the channel
    - `externalId` string — Deprecated, use 'externalIds' instead. For now, this returns the first entry of the 'externalIds' list.
    - `externalIds` string[] — External identifiers of the channel
    - `timeout` number, required — Timeout in seconds
    - `ads` object — OptiView Ads configuration
      - `enabled` boolean, required — Whether OptiView ads are enabled on the channel
      - `settings` object — Deprecated. Only returned for channels still using the old (V1) ads API underneath.
        - `assetKey` string — Deprecated. Use customAssetKey instead.
        - `layout` 'SINGLE' | 'DOUBLE' | 'LSHAPE_AD' | 'LSHAPE_CONTENT'
        - `enableBumperAds` boolean
        - `podDuration` number
        - `customAdTagParameters` object
    - `dvr` object — DVR configuration
      - `enabled` boolean, required — Whether DVR is enabled
      - `windowInSeconds` number — DVR window in seconds (60-86400)
    - `nielsen` object — Nielsen configuration
      - `enabled` boolean, required — Whether Nielsen is enabled
    - `instreamMetadata` object — Instream metadata configuration
      - `enabled` boolean, required — Whether instream metadata is enabled. Supported metadata is h264 registered or unregistered SEI metadata
      - `uuids` string[] — Array of instream metadata SEI UUIDs
    - `perpetual` boolean, required — Whether this channel is 24/7 (never times out, excluded from transcoding analytics)
    - `organizationId` string, required — Organization ID
  - `pagination` object, required — Pagination info
    - `hasMore` boolean, required — Whether more results are available
    - `cursor` string, required — Cursor for the next page of results

---

[API](https://skmtc.net/dolby/apis/theolive-api.md) · [All operations](https://skmtc.net/dolby/apis/theolive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dolby/theolive-api/versions/b57006d43141/schema)