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

# GET /datasets/{datasetId}/dataviewsv2/{dataviewId}

`GET /datasets/{datasetId}/dataviewsv2/{dataviewId}`

Gets information about a Dataview.

## Path parameters

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

## Response `200`

Success

- GetDataViewResponse — Response from retrieving a dataview, which includes details on the target database and table name
  - `autoUpdate` boolean — Flag to indicate Dataview should be updated automatically.
  - `partitionColumns` StringValueLength1to255[] — Ordered set of column names used to partition data.
  - `datasetId` string — The unique identifier for the Dataset used in the Dataview.
  - `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.
  - `errorInfo` object — Information about an error that occurred for the Dataview.
    - `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>
  - `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.
  - `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.
  - `sortColumns` StringValueLength1to255[] — Columns to be used for sorting the data.
  - `dataViewId` string — The unique identifier for the Dataview.
  - `dataViewArn` string — The ARN identifier of the Dataview.
  - `destinationTypeParams` object — Options that define the destination type for the Dataview.
    - `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>
  - `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>

## 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)