---
title: "POST /ListStreamSessions"
method: POST
path: "/ListStreamSessions"
---

# POST /ListStreamSessions

`POST /ListStreamSessions`

Gets a summary of current and previous streams for a specified channel in your account, in the AWS region where the API request is processed.

## Query parameters

- `maxResults` string
- `nextToken` string

## Request body

- object
  - `channelArn` string, required — Channel ARN used to filter the list.
  - `maxResults` integer — Maximum number of streams to return. Default: 100.
  - `nextToken` string — The first stream to retrieve. This is used for pagination; see the <code>nextToken</code> response field.

## Response `200`

Success

- ListStreamSessionsResponse
  - `nextToken` string — If there are more streams than <code>maxResults</code>, use <code>nextToken</code> in the request to get the next set.
  - `streamSessions` StreamSessionSummary[], required — List of stream sessions.
    - `endTime` string, date-time — Time when the channel went offline. This is an ISO 8601 timestamp; <i>note that this is returned as a string</i>. For live streams, this is <code>NULL</code>.
    - `hasErrorEvent` boolean — If <code>true</code>, this stream encountered a quota breach or failure.
    - `startTime` string, date-time — Time when the channel went live. This is an ISO 8601 timestamp; <i>note that this is returned as a string</i>.
    - `streamId` string — Unique identifier for a live or previously live stream in the specified channel.

## Other responses

- `480` — ResourceNotFoundException
- `481` — AccessDeniedException
- `482` — ValidationException

---

[API](https://skmtc.net/aws/apis/ivs.md) · [All operations](https://skmtc.net/aws/apis/ivs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/ivs/revisions/32a77504a115/schema)