---
title: "GET /streams/{streamId}"
method: GET
path: "/streams/{streamId}"
---

# GET /streams/{streamId}

`GET /streams/{streamId}`

Gets information about a stream.

Requires permission to access the [DescribeStream](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Path parameters

- `streamId` string, required

## Response `200`

Success

- DescribeStreamResponse
  - `streamInfo` object — Information about the stream.
    - `streamId` string — The stream ID.
    - `streamArn` string — The stream ARN.
    - `streamVersion` integer — The stream version.
    - `description` string — The description of the stream.
    - `files` StreamFile[] — The files to stream.
      - `fileId` integer — The file ID.
      - `s3Location` object — The location of the file in S3.
        - `bucket` string — The S3 bucket.
        - `key` string — The S3 key.
        - `version` string — The S3 bucket version.
    - `createdAt` string, date-time — The date when the stream was created.
    - `lastUpdatedAt` string, date-time — The date when the stream was last updated.
    - `roleArn` string — An IAM role IoT assumes to access your S3 files.

## Other responses

- `480` — InvalidRequestException
- `481` — ResourceNotFoundException
- `482` — ThrottlingException
- `483` — UnauthorizedException
- `484` — ServiceUnavailableException
- `485` — InternalFailureException

---

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