---
title: "Get distributions of a channel"
method: GET
path: "/channels/{id}/distributions"
tags: ["Channels", "Distributions"]
---

# Get distributions of a channel

`GET /channels/{id}/distributions`

Distributions are ordered alphabetically by name.

## Path parameters

- `id` string, required — Channel ID

## Query parameters

- `cursor` string — Pagination cursor
- `limit` number, nullable — Maximum number of items to return (max 100)

## Response `200`

List of distributions, ordered alphabetically by name

- PaginatedDistributionResult
  - `data` Distribution[], required — List of distributions
    - `id` string, required — Unique identifier of the distribution
    - `createdAt` string, required — Creation timestamp
    - `name` string, required — Name of the distribution
    - `externalId` string — External identifier for the distribution
    - `enabled` boolean, required — Whether the distribution is enabled
    - `targetLatency` number — Deprecated: use latencies instead.
    - `latencies` object, required — Latency configuration per output protocol
      - `hesp` number, nullable — HESP latency in seconds (1-30, default: 2)
      - `hls` number, nullable — HLS latency in seconds (8-30, default: 10)
    - `security` object, required — Security configuration
      - `geoBlocking` object, required — Geo-blocking configuration
        - `enabled` boolean, required — Whether geo-blocking is enabled
        - `mode` 'allow' | 'deny', required — Geo-blocking mode
        - `countries` string[], required — List of country codes
      - `ipBlocking` object, required — IP blocking configuration
        - `enabled` boolean, required — Whether IP blocking is enabled
        - `mode` 'allow' | 'deny', required — IP blocking mode
        - `cidrs` string[], required — List of CIDR ranges
      - `refererBlocking` object — Referer blocking configuration
        - `enabled` boolean, required — Whether referer blocking is enabled
        - `allowedDomains` string[], required — List of allowed domains
        - `allowNativeApps` boolean, required — Whether native apps are allowed
      - `rewriteSegmentUrls` boolean — When enabled, a short-lived token is added to the segment URLs, derived from the token that was passed. This only works when JWT security is enabled on the same distribution.
      - `keys` object[], required — Security keys
        - `id` string, required — Security key ID
        - `name` string — Security key name
    - `endpoints` object, required — Endpoint configuration
      - `engineIds` string[], required — Connected engine IDs
    - `webRtc` object — WebRTC configuration
      - `priority` number, required — WebRTC priority
      - `src` object, required — WebRTC source configuration
        - `name` string, required — WebRTC source name
        - `accountId` string, required — WebRTC account ID
        - `apiUrl` string, required — WebRTC API URL
    - `maxBitrate` number — Maximum bitrate limit in bps
    - `outputs` object — Output format configuration
      - `hesp` boolean — Enable HESP output. Enabled by default.
      - `hls` boolean — Enable HLS output. Enabled by default.
      - `hlsMpegTs` boolean — Enable HLS MPEG-TS output. Disabled by default.
    - `dvr` object, required — DVR configuration
      - `enabled` boolean — Whether DVR is enabled on the distribution
    - `overrides` object[] — Distribution overrides
      - `deviceType` 'tv' | 'mobile' | 'desktop' | 'other' | 'null', nullable — Target device type
      - `sdkType` 'native' | 'web' | 'null', nullable — Target SDK type
      - `osName` 'apple' | 'android' | 'windows' | 'roku' | 'other' | 'null', nullable — Target OS name
      - `profileId` string, nullable — Target profile ID
      - `targets` object[], required — Override target distributions with weights
        - `distributionId` string, required — Target distribution ID
        - `weight` number, required — Weight (0-100)
    - `customEndpoints` object[] — Connected custom endpoints with weights
      - `customEndpointId` string, required — ID of the connected custom endpoint
      - `weight` number, required — Weight (0-100)
    - `ads` object — Ads configuration for the distribution
      - `dai` object — DAI endpoint settings
        - `weight` integer, required — Weight for DAI endpoints (0-100)
        - `priority` integer, required — Priority for DAI endpoints (any integer, lower = higher priority)
  - `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)