---
title: "GET /datasets/{datasetName}/contents"
method: GET
path: "/datasets/{datasetName}/contents"
---

# GET /datasets/{datasetName}/contents

`GET /datasets/{datasetName}/contents`

Lists information about dataset contents that have been created.

## Path parameters

- `datasetName` string, required

## Query parameters

- `nextToken` string
- `maxResults` integer
- `scheduledOnOrAfter` string, date-time
- `scheduledBefore` string, date-time

## Response `200`

Success

- ListDatasetContentsResponse
  - `datasetContentSummaries` DatasetContentSummary[] — Summary information about dataset contents that have been created.
    - `version` string — The version of the dataset contents.
    - `status` object — The status of the dataset contents.
      - `state` 'CREATING' | 'SUCCEEDED' | 'FAILED' — The state of the dataset contents. Can be one of READY, CREATING, SUCCEEDED, or FAILED.
      - `reason` string — The reason the dataset contents are in this state.
    - `creationTime` string, date-time — The actual time the creation of the dataset contents was started.
    - `scheduleTime` string, date-time — The time the creation of the dataset contents was scheduled to start.
    - `completionTime` string, date-time — The time the dataset content status was updated to SUCCEEDED or FAILED.
  - `nextToken` string — The token to retrieve the next set of results, or <code>null</code> if there are no more results.

## Other responses

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

---

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