ListStreams - Amazon Kinesis Data Streams Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).


Lists your Kinesis data streams.

The number of streams may be too large to return from a single call to ListStreams. You can limit the number of returned streams using the Limit parameter. If you do not specify a value for the Limit parameter, Kinesis Data Streams uses the default limit, which is currently 100.

You can detect if there are more streams available to list by using the HasMoreStreams flag from the returned output. If there are more streams available, you can request more streams by using the name of the last stream returned by the ListStreams request in the ExclusiveStartStreamName parameter in a subsequent request to ListStreams. The group of stream names returned by the subsequent request is then added to the list. You can continue this process until all the stream names have been collected in the list.

ListStreams has a limit of five transactions per second per account.

Request Syntax

{ "ExclusiveStartStreamName": "string", "Limit": number, "NextToken": "string" }

Request Parameters

The request accepts the following data in JSON format.


The name of the stream to start the list with.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Pattern: [a-zA-Z0-9_.-]+

Required: No


The maximum number of streams to list. The default value is 100. If you specify a value greater than 100, at most 100 results are returned.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 10000.

Required: No


Type: String

Length Constraints: Minimum length of 1. Maximum length of 1048576.

Required: No

Response Syntax

{ "HasMoreStreams": boolean, "NextToken": "string", "StreamNames": [ "string" ], "StreamSummaries": [ { "StreamARN": "string", "StreamCreationTimestamp": number, "StreamModeDetails": { "StreamMode": "string" }, "StreamName": "string", "StreamStatus": "string" } ] }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


If set to true, there are more streams available to list.

Type: Boolean


Type: String

Length Constraints: Minimum length of 1. Maximum length of 1048576.


The names of the streams that are associated with the Amazon account making the ListStreams request.

Type: Array of strings

Length Constraints: Minimum length of 1. Maximum length of 128.

Pattern: [a-zA-Z0-9_.-]+


Type: Array of StreamSummary objects


For information about the errors that are common to all actions, see Common Errors.


The pagination token passed to the operation is expired.

HTTP Status Code: 400


A specified parameter exceeds its restrictions, is not supported, or can't be used. For more information, see the returned message.

HTTP Status Code: 400


The requested resource exceeds the maximum number allowed, or the number of concurrent stream requests exceeds the maximum number allowed.

HTTP Status Code: 400


To list your streams

The following JSON example lists your streams, starting with the specified stream.

Sample Request

POST / HTTP/1.1 Host: kinesis.<region>.<domain> Content-Length: <PayloadSizeBytes> User-Agent: <UserAgentString> Content-Type: application/x-amz-json-1.1 Authorization: <AuthParams> Connection: Keep-Alive X-Amz-Date: <Date> X-Amz-Target: Kinesis_20131202.ListStreams

Sample Response

HTTP/1.1 200 OK x-amzn-RequestId: <RequestId> Content-Type: application/x-amz-json-1.1 Content-Length: <PayloadSizeBytes> Date: <Date> { "HasMoreStreams": false, "StreamNames": [ "exampleStreamName" ] }

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: