---
title: "Retrieve channels"
method: GET
path: "/saas/channels"
tags: ["Channel"]
---

# Retrieve channels

`GET /saas/channels`

List the caller's channels, optionally filtered by event and/or stage.

## Query parameters

- `event_id` string, uuid4
- `stage_id` string, uuid4

## Response `200`

Successful Response

- GenericResponsePayloadListChannelsResponseData
  - `ok` boolean — Indicates if the request was successful or not.
  - `data` ListChannelsResponseDataOutput, required
    - `channels` CreateChannelResponseData[]
      - `id` string — Broadcast ID
      - `user` string — Owner user ID
      - `title` string — Broadcast title
      - `region` string — Deployment/ingest region
      - `status` string — Runtime status (pending/active/failed/stopped)
      - `error` string — Error description, if any
      - `input_bitrate` integer — Measured input bitrate
      - `ignore_video` boolean
      - `original_delay_seconds` integer
      - `original_ducked_volume` union
        - number
        - integer
      - `input` object — Resolved input endpoint/credentials
      - `outputs` unknown[] — Configured egress outputs
        - unknown
      - `translation_pipeline` object — Translation pipeline settings
      - `channel_id` string, uuid, required — Channel ID (public_api addressing key)
      - `type` 'event' | 'standalone', required
      - `event_id` string, uuid — Parent event ID
      - `stage_id` string, uuid — Parent stage ID
      - `broadcast_id` string, uuid — Underlying broadcast ID; null when broadcaster create failed
      - `input_type` 'webrtc_push' | 'rtmp_push' | 'srt_push' | 'hls_pull', required
      - `room_name_suffix` string — LiveKit room name suffix
      - `runtime_status` 'pending' | 'running' | 'errored'
      - `audio_settings` object — Channel audio settings
      - `cache_synced_at` string, date-time — Last broadcaster sync time in UTC
      - `utc_created_at` string, date-time, required — Channel creation time in UTC
      - `utc_updated_at` string, date-time, required — Channel last update time in UTC

## Other responses

- `default` — Default Response

---

[API](https://skmtc.dev/palabra/apis/palabra-api.md) · [All operations](https://skmtc.dev/palabra/apis/palabra-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/palabra/palabra-api/revisions/cb8721654525/schema)