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

# Get restreams of a channel

`GET /channels/{id}/restreams`

## Request

- Base URL: `https://api.theo.live/v2`
- URL: `https://api.theo.live/v2/channels/{id}/restreams`
- Auth: HTTP basic

A restream pushes the stream of an ingest or engine of a channel to an external RTMP or SRT destination. Restreams are only available when restreaming is enabled for the organization (403 `feature_not_enabled` otherwise). Restreams are ordered by creation date.

## 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`

Paginated list of restreams

- PaginatedChannelRestreamResult
  - `data` ChannelRestream[], required: List of restreams
    - `id` string, required: Unique identifier of the restream
    - `createdAt` string, required: Creation timestamp
    - `updatedAt` string, required: Last update timestamp
    - `channelId` string, required: Id of the channel the restream belongs to
    - `type` 'ingest' | 'engine', required: Source type of the restream: `ingest` restreams the incoming stream of an rtmp-push or srt-push ingest as-is, `engine` restreams the transcoded output of an engine
    - `src` string, required: Id of the ingest or engine (depending on `type`) to restream. Must be connected to the same channel
    - `target` string, required: Push URL the stream is sent to. An `ingest` restream uses the protocol of its ingest (srt:// for srt-push, rtmp:// or rtmps:// for rtmp-push); an `engine` restream only supports rtmp:// or rtmps://
    - `status` 'stopped' | 'active', required: Whether the restream is currently pushing to its target (`active`) or not (`stopped`)
  - `pagination` object, required: Pagination info
    - `hasMore` boolean, required: Whether more results are available
    - `cursor` string, required: Cursor for the next page of results

## Changes

- **2026-11-06** `baabda2927db`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/dolby/apis/theolive-api/changes/channels/:id/restreams/get.md)

---

[API](https://skmtc.dev/dolby/apis/theolive-api.md) - [All operations](https://skmtc.dev/dolby/apis/theolive-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dolby/apis/theolive-api/revisions/baabda2927db?raw)