--- title: "List Channels" method: GET path: "/channels" tags: ["Channels"] --- # List Channels `GET /channels` ## Request - Base URL: `https://api.wistia.com/modern` - URL: `https://api.wistia.com/modern/channels` - Auth: HTTP bearer Lists all Channels belonging to an account. This endpoint can also be used to do a batch fetch based off of the hashed id. ## Requires api token with one of the following permissions ``` Read all folder and media data ``` Tokens with the "Act with a team member's permissions" permission (`all:delegate_to_contact_permissions` scope) can also be used. Requests made with such a token are authorized using the permissions of the contact assigned to the token. An [expiring access token](https://docs.wistia.com/reference/post_expiring-token) created with the `all:delegate_to_contact_permissions` scope and an authorization naming a channel (any permission) can also be used; it lists the channels the token names. ## Query parameters - `cursor` object - `enabled` 0 | 1: If `cursor[enabled]` is set to 1, the first result set will be fetched with cursor pagination enabled. This values is ignored if `cursor[before]` or `cursor[after]` are set. - `before` string: If `cursor[before]` is set then cursor pagination is enabled and all records before the cursor up to the `per_page` are returned. This feature is useful for fetching "new records", for example, in a "pull to refersh" feature when showing records in a descending order. - `after` string: If `cursor[after]` is set then cursor pagination is enabled and all records after the cursor up to the `per_page` are returned. - `page` integer - `per_page` integer - `sort_by` 'created' | 'id' | 'updated' | 'name' - `sort_direction` 0 | 1 - `hashed_ids[]` string[] ## Headers - `X-Wistia-API-Version` string, required ## Response `200` Channels retrieval successful - object[] - `id` integer, required: The numeric id of the channel. - `created` string, date-time, required: The date when the channel was originally created. - `description` string, required: The channel's description. - `hashed_id` string, required: A unique alphanumeric identifier for this channel. - `media_count` integer, required: The number of medias in the channel. - `live_stream_event_count` integer: The number of live stream events in the channel. - `name` string, required: The display name for the channel - `updated` string, date-time, required: The date when the channel was last updated. - `auto_publish_enabled` boolean, nullable: Whether episodes are automatically published when added to the channel. - `podcast_enabled` boolean, nullable: Whether podcasting is enabled for the channel. - `custom_url` string, nullable: The custom URL used when embedding the channel on your own site. Null if no custom URL is set. - `podcast_settings` object: Podcast specific settings for the channel. Only present when podcasting is enabled for the channel. - `copyright` string, nullable: The channel's copyright information, published in the RSS feed as ``. - `episode_format` 'episodic' | 'episodic_with_seasons' | 'serial', nullable: The format for episodes for the podcast channel, published in the RSS feed as ``. `episodic_with_seasons` is published as `episodic`. - `author_name` string, nullable: The name of the author(s) for the channel, published in the RSS feed as ``. - `explicit` boolean, nullable: Whether the channel contains explicit content, published in the RSS feed as ``. - `owner_name` string, nullable: The podcast owner's name, published in the channel's public RSS feed as ``. Podcast directories use this as the show's administrative contact. - `owner_email` string, nullable: The podcast owner's email address, published in the channel's public RSS feed as ``. Podcast directories such as Apple Podcasts require it for ownership verification. - `category1` 'arts' | 'arts > books' | 'arts > design' | 'arts > fashion_and_beauty' | 'arts > food' | 'arts > performing_arts' | 'arts > visual_arts' | 'business' | 'business > careers' | 'business > entrepreneurship' | 'business > investing' | 'business > management' | 'business > marketing' | 'business > non_profit' | 'comedy' | 'comedy > comedy_interviews' | 'comedy > improv' | 'comedy > stand_up' | 'education' | 'education > courses' | 'education > how_to' | 'education > language_learning' | 'education > self_improvement' | 'fiction' | 'fiction > comedy_fiction' | 'fiction > drama' | 'fiction > science_fiction' | 'government' | 'health_and_fitness' | 'health_and_fitness > alternative_health' | 'health_and_fitness > fitness' | 'health_and_fitness > medicine' | 'health_and_fitness > mental_health' | 'health_and_fitness > nutrition' | 'health_and_fitness > sexuality' | 'history' | 'kids_and_family' | 'kids_and_family > education_for_kids' | 'kids_and_family > parenting' | 'kids_and_family > pets_and_animals' | 'kids_and_family > stories_for_kids' | 'leisure' | 'leisure > animation_and_manga' | 'leisure > automotive' | 'leisure > aviation' | 'leisure > crafts' | 'leisure > games' | 'leisure > hobbies' | 'leisure > home_and_garden' | 'leisure > video_games' | 'music' | 'music > music_commentary' | 'music > music_history' | 'music > music_interviews' | 'news' | 'news > business_news' | 'news > daily_news' | 'news > entertainment_news' | 'news > news_commentary' | 'news > politics' | 'news > sports_news' | 'news > tech_news' | 'religion_and_spirituality' | 'religion_and_spirituality > buddhism' | 'religion_and_spirituality > christianity' | 'religion_and_spirituality > hinduism' | 'religion_and_spirituality > islam' | 'religion_and_spirituality > judaism' | 'religion_and_spirituality > religion' | 'religion_and_spirituality > spirituality' | 'science' | 'science > astronomy' | 'science > chemistry' | 'science > earth_sciences' | 'science > life_sciences' | 'science > mathematics' | 'science > natural_sciences' | 'science > nature' | 'science > physics' | 'science > social_sciences' | 'society_and_culture' | 'society_and_culture > documentary' | 'society_and_culture > personal_journals' | 'society_and_culture > philosophy' | 'society_and_culture > places_and_travel' | 'society_and_culture > relationships' | 'sports' | 'sports > baseball' | 'sports > basketball' | 'sports > cricket' | 'sports > fantasy_sports' | 'sports > football' | 'sports > golf' | 'sports > hockey' | 'sports > rugby' | 'sports > running' | 'sports > soccer' | 'sports > swimming' | 'sports > tennis' | 'sports > volleyball' | 'sports > wilderness' | 'sports > wrestling' | 'technology' | 'true_crime' | 'tv_and_film' | 'tv_and_film > after_shows' | 'tv_and_film > film_history' | 'tv_and_film > film_interviews' | 'tv_and_film > film_reviews' | 'tv_and_film > tv_reviews', nullable: The primary category for the channel, published in the RSS feed as ``. - `category2` 'arts' | 'arts > books' | 'arts > design' | 'arts > fashion_and_beauty' | 'arts > food' | 'arts > performing_arts' | 'arts > visual_arts' | 'business' | 'business > careers' | 'business > entrepreneurship' | 'business > investing' | 'business > management' | 'business > marketing' | 'business > non_profit' | 'comedy' | 'comedy > comedy_interviews' | 'comedy > improv' | 'comedy > stand_up' | 'education' | 'education > courses' | 'education > how_to' | 'education > language_learning' | 'education > self_improvement' | 'fiction' | 'fiction > comedy_fiction' | 'fiction > drama' | 'fiction > science_fiction' | 'government' | 'health_and_fitness' | 'health_and_fitness > alternative_health' | 'health_and_fitness > fitness' | 'health_and_fitness > medicine' | 'health_and_fitness > mental_health' | 'health_and_fitness > nutrition' | 'health_and_fitness > sexuality' | 'history' | 'kids_and_family' | 'kids_and_family > education_for_kids' | 'kids_and_family > parenting' | 'kids_and_family > pets_and_animals' | 'kids_and_family > stories_for_kids' | 'leisure' | 'leisure > animation_and_manga' | 'leisure > automotive' | 'leisure > aviation' | 'leisure > crafts' | 'leisure > games' | 'leisure > hobbies' | 'leisure > home_and_garden' | 'leisure > video_games' | 'music' | 'music > music_commentary' | 'music > music_history' | 'music > music_interviews' | 'news' | 'news > business_news' | 'news > daily_news' | 'news > entertainment_news' | 'news > news_commentary' | 'news > politics' | 'news > sports_news' | 'news > tech_news' | 'religion_and_spirituality' | 'religion_and_spirituality > buddhism' | 'religion_and_spirituality > christianity' | 'religion_and_spirituality > hinduism' | 'religion_and_spirituality > islam' | 'religion_and_spirituality > judaism' | 'religion_and_spirituality > religion' | 'religion_and_spirituality > spirituality' | 'science' | 'science > astronomy' | 'science > chemistry' | 'science > earth_sciences' | 'science > life_sciences' | 'science > mathematics' | 'science > natural_sciences' | 'science > nature' | 'science > physics' | 'science > social_sciences' | 'society_and_culture' | 'society_and_culture > documentary' | 'society_and_culture > personal_journals' | 'society_and_culture > philosophy' | 'society_and_culture > places_and_travel' | 'society_and_culture > relationships' | 'sports' | 'sports > baseball' | 'sports > basketball' | 'sports > cricket' | 'sports > fantasy_sports' | 'sports > football' | 'sports > golf' | 'sports > hockey' | 'sports > rugby' | 'sports > running' | 'sports > soccer' | 'sports > swimming' | 'sports > tennis' | 'sports > volleyball' | 'sports > wilderness' | 'sports > wrestling' | 'technology' | 'true_crime' | 'tv_and_film' | 'tv_and_film > after_shows' | 'tv_and_film > film_history' | 'tv_and_film > film_interviews' | 'tv_and_film > film_reviews' | 'tv_and_film > tv_reviews', nullable: The secondary category for the channel, published in the RSS feed as ``. - `category3` 'arts' | 'arts > books' | 'arts > design' | 'arts > fashion_and_beauty' | 'arts > food' | 'arts > performing_arts' | 'arts > visual_arts' | 'business' | 'business > careers' | 'business > entrepreneurship' | 'business > investing' | 'business > management' | 'business > marketing' | 'business > non_profit' | 'comedy' | 'comedy > comedy_interviews' | 'comedy > improv' | 'comedy > stand_up' | 'education' | 'education > courses' | 'education > how_to' | 'education > language_learning' | 'education > self_improvement' | 'fiction' | 'fiction > comedy_fiction' | 'fiction > drama' | 'fiction > science_fiction' | 'government' | 'health_and_fitness' | 'health_and_fitness > alternative_health' | 'health_and_fitness > fitness' | 'health_and_fitness > medicine' | 'health_and_fitness > mental_health' | 'health_and_fitness > nutrition' | 'health_and_fitness > sexuality' | 'history' | 'kids_and_family' | 'kids_and_family > education_for_kids' | 'kids_and_family > parenting' | 'kids_and_family > pets_and_animals' | 'kids_and_family > stories_for_kids' | 'leisure' | 'leisure > animation_and_manga' | 'leisure > automotive' | 'leisure > aviation' | 'leisure > crafts' | 'leisure > games' | 'leisure > hobbies' | 'leisure > home_and_garden' | 'leisure > video_games' | 'music' | 'music > music_commentary' | 'music > music_history' | 'music > music_interviews' | 'news' | 'news > business_news' | 'news > daily_news' | 'news > entertainment_news' | 'news > news_commentary' | 'news > politics' | 'news > sports_news' | 'news > tech_news' | 'religion_and_spirituality' | 'religion_and_spirituality > buddhism' | 'religion_and_spirituality > christianity' | 'religion_and_spirituality > hinduism' | 'religion_and_spirituality > islam' | 'religion_and_spirituality > judaism' | 'religion_and_spirituality > religion' | 'religion_and_spirituality > spirituality' | 'science' | 'science > astronomy' | 'science > chemistry' | 'science > earth_sciences' | 'science > life_sciences' | 'science > mathematics' | 'science > natural_sciences' | 'science > nature' | 'science > physics' | 'science > social_sciences' | 'society_and_culture' | 'society_and_culture > documentary' | 'society_and_culture > personal_journals' | 'society_and_culture > philosophy' | 'society_and_culture > places_and_travel' | 'society_and_culture > relationships' | 'sports' | 'sports > baseball' | 'sports > basketball' | 'sports > cricket' | 'sports > fantasy_sports' | 'sports > football' | 'sports > golf' | 'sports > hockey' | 'sports > rugby' | 'sports > running' | 'sports > soccer' | 'sports > swimming' | 'sports > tennis' | 'sports > volleyball' | 'sports > wilderness' | 'sports > wrestling' | 'technology' | 'true_crime' | 'tv_and_film' | 'tv_and_film > after_shows' | 'tv_and_film > film_history' | 'tv_and_film > film_interviews' | 'tv_and_film > film_reviews' | 'tv_and_film > tv_reviews', nullable: The third category for the channel, published in the RSS feed as ``. - `language` 'af' | 'be' | 'bg' | 'ca' | 'cs' | 'da' | 'de-at' | 'de-ch' | 'de-de' | 'de-li' | 'de-lu' | 'de' | 'el' | 'en-au' | 'en-bz' | 'en-ca' | 'en-gb' | 'en-ie' | 'en-jm' | 'en-nz' | 'en-ph' | 'en-tt' | 'en-us' | 'en-za' | 'en-zw' | 'en' | 'es-ar' | 'es-bo' | 'es-cl' | 'es-co' | 'es-cr' | 'es-do' | 'es-ec' | 'es-es' | 'es-gt' | 'es-hn' | 'es-mx' | 'es-ni' | 'es-pa' | 'es-pe' | 'es-pr' | 'es-py' | 'es-sv' | 'es-uy' | 'es-ve' | 'es' | 'et' | 'eu' | 'fi' | 'fo' | 'fr-be' | 'fr-ca' | 'fr-ch' | 'fr-fr' | 'fr-lu' | 'fr-mc' | 'fr' | 'ga' | 'gd' | 'gl' | 'haw' | 'hr' | 'hu' | 'in' | 'is' | 'it-ch' | 'it-it' | 'it' | 'ja' | 'ko' | 'mk' | 'nl-be' | 'nl-nl' | 'nl' | 'no' | 'pl' | 'pt-br' | 'pt-pt' | 'pt' | 'ro-mo' | 'ro-ro' | 'ro' | 'ru-mo' | 'ru-ru' | 'ru' | 'sk' | 'sl' | 'sq' | 'sr' | 'sv-fi' | 'sv-se' | 'sv' | 'tr' | 'uk' | 'zh-cn' | 'zh-tw', nullable: The ISO 639-1 language code for the channel, published in the RSS feed as ``. - `cursor` string, nullable: A cursor for stable pagination based on current `sort_by` order. You can pass this to `cursor[before]` or `cursor[after]` as a parameter to fetch the records before or after this record in the same sort order. This is only populated if records were fetched with `cursor[enabled]`, or `cursor[before]` or `cursor[after]`. ## Other responses - `400`: Bad request - `401`: Unauthorized, invalid or missing token - `500`: Internal server error ## Changes - **2026-11-03** `b86cb2a7b420`: 1 info - endpoint added [Operation history](https://skmtc.dev/wistia/apis/data-api/changes/channels/get.md) --- [API](https://skmtc.dev/wistia/apis/data-api.md) - [All operations](https://skmtc.dev/wistia/apis/data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wistia/apis/data-api/revisions/b86cb2a7b420?raw)