---
title: "GET /datasets/{datasetId}/dataviewsv2"
method: GET
path: "/datasets/{datasetId}/dataviewsv2"
---

# GET /datasets/{datasetId}/dataviewsv2

`GET /datasets/{datasetId}/dataviewsv2`

Lists all available Dataviews for a Dataset.

## Path parameters

- `datasetId` string, required — ID for a given Dataset

## Query parameters

- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListDataViewsResponse
  - `nextToken` string — A token that indicates where a results page should begin.
  - `dataViews` DataViewSummary[] — A list of Dataviews.
    - `dataViewId` string — The unique identifier for the Dataview.
    - `dataViewArn` string — The ARN identifier of the Dataview.
    - `datasetId` string — Th unique identifier for the Dataview Dataset.
    - `asOfTimestamp` integer — Time range to use for the Dataview. The value is determined as epoch time in milliseconds. For example, the value for Monday, November 1, 2021 12:00:00 PM UTC is specified as 1635768000000.
    - `partitionColumns` StringValueLength1to255[] — Ordered set of column names used to partition data.
    - `sortColumns` StringValueLength1to255[] — Columns to be used for sorting the data.
    - `status` 'RUNNING' | 'STARTING' | 'FAILED' | 'CANCELLED' | 'TIMEOUT' | 'SUCCESS' | 'PENDING' | 'FAILED_CLEANUP_FAILED' — <p>The status of a Dataview creation.</p> <ul> <li> <p> <code>RUNNING</code> – Dataview creation is running.</p> </li> <li> <p> <code>STARTING</code> – Dataview creation is starting.</p> </li> <li> <p> <code>FAILED</code> – Dataview creation has failed.</p> </li> <li> <p> <code>CANCELLED</code> – Dataview creation has been cancelled.</p> </li> <li> <p> <code>TIMEOUT</code> – Dataview creation has timed out.</p> </li> <li> <p> <code>SUCCESS</code> – Dataview creation has succeeded.</p> </li> <li> <p> <code>PENDING</code> – Dataview creation is pending.</p> </li> <li> <p> <code>FAILED_CLEANUP_FAILED</code> – Dataview creation failed and resource cleanup failed.</p> </li> </ul>
    - `errorInfo` object — The structure with error messages.
      - `errorMessage` string — The text of the error message.
      - `errorCategory` 'VALIDATION' | 'SERVICE_QUOTA_EXCEEDED' | 'ACCESS_DENIED' | 'RESOURCE_NOT_FOUND' | 'THROTTLING' | 'INTERNAL_SERVICE_EXCEPTION' | 'CANCELLED' | 'USER_RECOVERABLE' — <p>The category of the error.</p> <ul> <li> <p> <code>VALIDATION</code> – The inputs to this request are invalid.</p> </li> <li> <p> <code>SERVICE_QUOTA_EXCEEDED</code> – Service quotas have been exceeded. Please contact AWS support to increase quotas.</p> </li> <li> <p> <code>ACCESS_DENIED</code> – Missing required permission to perform this request.</p> </li> <li> <p> <code>RESOURCE_NOT_FOUND</code> – One or more inputs to this request were not found.</p> </li> <li> <p> <code>THROTTLING</code> – The system temporarily lacks sufficient resources to process the request.</p> </li> <li> <p> <code>INTERNAL_SERVICE_EXCEPTION</code> – An internal service error has occurred.</p> </li> <li> <p> <code>CANCELLED</code> – Cancelled.</p> </li> <li> <p> <code>USER_RECOVERABLE</code> – A user recoverable error has occurred.</p> </li> </ul>
    - `destinationTypeProperties` object — Information about the Dataview destination.
      - `destinationType` string, required — <p>Destination type for a Dataview.</p> <ul> <li> <p> <code>GLUE_TABLE</code> – Glue table destination type.</p> </li> <li> <p> <code>S3</code> – S3 destination type.</p> </li> </ul>
      - `s3DestinationExportFileFormat` 'PARQUET' | 'DELIMITED_TEXT' — <p>Dataview export file format.</p> <ul> <li> <p> <code>PARQUET</code> – Parquet export file format.</p> </li> <li> <p> <code>DELIMITED_TEXT</code> – Delimited text export file format.</p> </li> </ul>
      - `s3DestinationExportFileFormatOptions` object — <p>Format Options for S3 Destination type.</p> <p>Here is an example of how you could specify the <code>s3DestinationExportFileFormatOptions</code> </p> <p> <code> { "header": "true", "delimiter": ",", "compression": "gzip" }</code> </p>
    - `autoUpdate` boolean — The flag to indicate Dataview should be updated automatically.
    - `createTime` integer — The timestamp at which the Dataview was created in FinSpace. The value is determined as epoch time in milliseconds. For example, the value for Monday, November 1, 2021 12:00:00 PM UTC is specified as 1635768000000.
    - `lastModifiedTime` integer — The last time that a Dataview was modified. The value is determined as epoch time in milliseconds. For example, the value for Monday, November 1, 2021 12:00:00 PM UTC is specified as 1635768000000.

## Other responses

- `480` — ResourceNotFoundException
- `481` — InternalServerException
- `482` — ThrottlingException
- `483` — ValidationException
- `484` — ConflictException

---

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