List Channel Episodes by Channel

get

https://api.wistia.com/modern/channels/{channelHashedId}/channel_episodes

Lists Channel Episodes belonging to the channel passed in the path.

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
created with the all:delegate_to_contact_permissions scope and an
authorization naming a channel (any permission) can also be used; it
lists the episodes of the channels the token names.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

channelHashedId

string

required

The hashed ID of the channel to grab channel episodes from.

Query Params

sort_by

string

enum

Ordering. Default is ID ASC. When using cursor pagination (see cursor param),
only id and created are supported. All other sort_by options (position, title, updated, published_at)
require offset pagination.

Allowed:

sort_direction

integer

enum

Ordering Sort Direction (0 = desc, 1 = asc; default is 1)

Allowed:

page

integer

The page number to retrieve. This cannot be combined with cursor,
pagination.

per_page

integer

The number of medias per page. Use this for both offset pagination and cursor pagination.

cursor

object

If cursor[enabled] is set to 1 then cursor pagination is enabled and the
first set of records are fetched up to the per_page. Cursor
pagination will also be turned on if cursor[before] or cursor[after]
are set. Records returned will have a cursor property set which can be used to fetch more records in the same sort_by ordering.
The cursor value of the last record can be used to fetch records after the current result set and
the cursor of the first record can be used to fetch records before the result set.

NOTE: a cursor value is only valid if the sort_by value hasn't changed from the
last fetch. For example, you cannot fetch using sort_by id and then pass that
cursor value to a sort_by name.

media_id[]

array of strings

Filter by media id. Accepts either the numeric id or the hashed id of a media.

media_id[]

hashed_ids[]

array of strings

Filter by hashed id

hashed_ids[]

published

boolean

Filter by published status.

title

string

Filter by channel episode name/title.

Headers

X-Wistia-API-Version

string

required

Defaults to 2026-09

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Channel Episodes retrieval successful

400Bad request

401Unauthorized, invalid or missing token

500Internal server error