---
title: "Retrieve a channel"
method: GET
path: "/channels/{id}"
tags: ["Channels"]
---

# Retrieve a channel

`GET /channels/{id}`

## Path parameters

- `id` string, required

## Headers

- `organization` string, required

## Response `200`

Successful response

- ChannelRestOutput
  - `id` string — Channel ID
  - `name` string — Channel name
  - `slug` string — Channel slug
  - `organization` string — Organization ID
  - `description` string — Channel description
  - `status` string — Channel status
  - `geofence` GeofenceObject
    - `countryCodes` string[]
    - `type` 'WHITELIST' | 'BLACKLIST'
  - `customization` CustomizationObject
    - `logo` object — Logo image
      - `light` ImageDetails, required
        - `imgPath` string, required — The path to the image.
        - `baseUrl` string, required — The base URL for the image.
      - `dark` ImageDetails, required
        - `imgPath` string, required — The path to the image.
        - `baseUrl` string, required — The base URL for the image.
    - `icon` object — Icon image
      - `light` ImageDetails, required
        - `imgPath` string, required — The path to the image.
        - `baseUrl` string, required — The base URL for the image.
      - `dark` ImageDetails, required
        - `imgPath` string, required — The path to the image.
        - `baseUrl` string, required — The base URL for the image.
    - `thumbnail` ImageDetails
      - `imgPath` string, required — The path to the image.
      - `baseUrl` string, required — The base URL for the image.
  - `entitlements` string[] — Array of product IDs
  - `geofenceEntitlements` unknown[] — Geofence entitlements
    - unknown
  - `kind` string — The access level of the channel
  - `access` string — States if the channel is universally available or geolocked.

---

[API](https://skmtc.net/fanhero/apis/tenant-endpoints.md) · [All operations](https://skmtc.net/fanhero/apis/tenant-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fanhero/tenant-endpoints/versions/8e7584c449dc/schema)