---
title: "List Subscribr Video channels for the current team"
method: GET
path: "/api/v1/video/channels"
tags: ["video"]
---

# List Subscribr Video channels for the current team

`GET /api/v1/video/channels`

## Request

- Base URL: `https://subscribr.ai`
- URL: `https://subscribr.ai/api/v1/video/channels`
- Auth: HTTP bearer

## Response `200`

Video channels.

- VideoChannelListResponse
  - `data` VideoChannel[], required
    - `configuration` VideoChannelConfiguration, required
      - `active` boolean, required
      - `captions` object, required
        - `enabled` boolean, required
        - `style` string, nullable, required
      - `music` object, required
        - `enabled` boolean, required
        - `sfx_family` string, nullable, required
      - `pacing` object, required
        - `pace_profile` string, nullable, required
        - `slideshow_max_seconds` integer, nullable, required
        - `structure_hint` string, nullable, required
      - `post_processing` object, required
        - `profile` string, nullable, required
      - `presenter` object, required
        - `avatar` VideoChannelIdentitySelection, required
          - `identity_status` 'none' | 'unresolved' | 'resolved' | 'pending_migration', required
          - `resource_id` string, uuid, nullable, required
          - `selection` 'none' | 'catalog' | 'custom_asset', required
        - `layout` object, required
          - `position` string, nullable, required
          - `style` string, nullable, required
        - `look` VideoChannelCatalogIdentitySelection, required
          - `identity_status` 'none' | 'unresolved', required
          - `resource_id` unknown, required
          - `selection` 'none' | 'catalog', required
        - `type` string, nullable, required
      - `reference_media` object, required
        - `attachment_count` integer, required
        - `identity_status` 'none' | 'unresolved', required
        - `resource_ids` string[], required
      - `style` object, required
        - `configured` boolean, required
      - `theme` object, required
        - `id` string, nullable, required
        - `overrides` object, required
          - `archival_treatment` string, nullable, required
          - `brand_accent_color` string, nullable, required
          - `brand_highlight_color` string, nullable, required
          - `data_count_treatment` string, nullable, required
          - `evidence_label_style` string, nullable, required
          - `section_reset_treatment` string, nullable, required
      - `voice` object, required
        - `delivery_mode` string, nullable, required
        - `identity_status` 'none' | 'unresolved' | 'resolved' | 'pending_migration', required
        - `resource_id` string, uuid, nullable, required
        - `selection` 'none' | 'catalog' | 'custom_asset', required
        - `speaking_rate` number, required
    - `configuration_revision` integer, required
    - `created_at` string, date-time, required
    - `display_name` string, required
    - `handle` string, required
    - `id` string, required
    - `mode` string, nullable, required
    - `origin` object, required
      - `kind` 'linked' | 'standalone', required
      - `main_channel_id` string, nullable, required
    - `readiness` object, required
      - `missing_requirements` string[], required
      - `status` 'ready' | 'incomplete', required
    - `updated_at` string, date-time, required

## Other responses

- `400`: The request could not be processed.
- `401`: Authentication is required.
- `403`: The token, role, entitlement, or object policy denies this action.
- `404`: The resource was not found or is not visible.
- `422`: One or more request fields are invalid.
- `429`: The request exceeded a rate limit.
- `500`: The service is temporarily unavailable.
- `503`: The service is temporarily unavailable.

---

[API](https://skmtc.dev/subscribr/apis/subscribr-customer-api.md) · [All operations](https://skmtc.dev/subscribr/apis/subscribr-customer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/subscribr/apis/subscribr-customer-api/revisions/d1f105b58bbd?raw)