---
title: "Get a video channel"
method: GET
path: "/api/v1/video-channels/{channelHandle}"
tags: ["Video Channels"]
---

# Get a video channel

`GET /api/v1/video-channels/{channelHandle}`

## Path parameters

- `channelHandle` string, required

## Response `200`

successful operation

- VideoChannel
  - `createdAt` string, date-time
  - `followersCount` integer — number of followers of this actor, as seen by this instance
  - `followingCount` integer — number of actors subscribed to by this actor, as seen by this instance
  - `host` string, hostname — server on which the actor is resident
  - `hostRedundancyAllowed` boolean — whether this actor's host allows redundancy of its videos
  - `id` integer
  - `name` string — immutable name of the user, used to find or mention its actor
  - `updatedAt` string, date-time
  - `url` string, url
  - `banners` ActorImage[]
    - `createdAt` string, date-time
    - `path` string
    - `updatedAt` string, date-time
    - `width` integer
  - `description` string
  - `displayName` string — editable name of the channel, displayed in its representations
  - `isLocal` boolean
  - `ownerAccount` object, nullable
    - `id` integer
    - `uuid` string, uuid
  - `support` string — text shown by default on all videos of this channel, to tell the audience how to support it

---

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