---
title: "GET /channels"
method: GET
path: "/channels"
---

# GET /channels

`GET /channels`

Retrieves information about the channels that are associated with the current AWS account.

## Query parameters

- `maxResults` integer
- `nextToken` string
- `MaxResults` string
- `NextToken` string

## Response `200`

Success

- ListChannelsResponse
  - `Items` Channel[] — A list of channels that are associated with this account.
    - `Arn` string, required — The ARN of the channel.
    - `ChannelName` string, required — The name of the channel.
    - `ChannelState` string, required — Returns the state whether the channel is running or not.
    - `CreationTime` string, date-time — The timestamp of when the channel was created.
    - `FillerSlate` object — The slate used to fill gaps between programs in the schedule. You must configure filler slate if your channel uses the <code>LINEAR</code> <code>PlaybackMode</code>. MediaTailor doesn't support filler slate for channels using the <code>LOOP</code> <code>PlaybackMode</code>.
      - `SourceLocationName` string — The name of the source location where the slate VOD source is stored.
      - `VodSourceName` string — The slate VOD source name. The VOD source must already exist in a source location before it can be used for slate.
    - `LastModifiedTime` string, date-time — The timestamp of when the channel was last modified.
    - `LogConfiguration` object, required — The log configuration.
      - `LogTypes` LogType[] — The log types.
    - `Outputs` ResponseOutputItem[], required — The channel's output properties.
      - `DashPlaylistSettings` object — DASH manifest configuration settings.
        - `ManifestWindowSeconds` integer — The total duration (in seconds) of each manifest. Minimum value: <code>30</code> seconds. Maximum value: <code>3600</code> seconds.
        - `MinBufferTimeSeconds` integer — Minimum amount of content (measured in seconds) that a player must keep available in the buffer. Minimum value: <code>2</code> seconds. Maximum value: <code>60</code> seconds.
        - `MinUpdatePeriodSeconds` integer — Minimum amount of time (in seconds) that the player should wait before requesting updates to the manifest. Minimum value: <code>2</code> seconds. Maximum value: <code>60</code> seconds.
        - `SuggestedPresentationDelaySeconds` integer — Amount of time (in seconds) that the player should be from the live point at the end of the manifest. Minimum value: <code>2</code> seconds. Maximum value: <code>60</code> seconds.
      - `HlsPlaylistSettings` object — HLS manifest configuration settings.
        - `ManifestWindowSeconds` integer — The total duration (in seconds) of each manifest. Minimum value: <code>30</code> seconds. Maximum value: <code>3600</code> seconds.
      - `ManifestName` string, required — The name of the manifest for the channel that will appear in the channel output's playback URL.
      - `PlaybackUrl` string, required — The URL used for playback by content players.
      - `SourceGroup` string, required — A string used to associate a package configuration source group with a channel output.
    - `PlaybackMode` string, required — <p>The type of playback mode for this channel.</p> <p> <code>LINEAR</code> - Programs play back-to-back only once.</p> <p> <code>LOOP</code> - Programs play back-to-back in an endless loop. When the last program in the schedule plays, playback loops back to the first program in the schedule.</p>
    - `Tags` object — The tags to assign to the channel. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. For more information, see <a href="https://docs.aws.amazon.com/mediatailor/latest/ug/tagging.html">Tagging AWS Elemental MediaTailor Resources</a>.
    - `Tier` string, required — The tier for this channel. STANDARD tier channels can contain live programs.
  - `NextToken` string — Pagination token returned by the list request when results exceed the maximum allowed. Use the token to fetch the next page of results.

---

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