---
title: "GET /datasetsv2/{datasetId}"
method: GET
path: "/datasetsv2/{datasetId}"
---

# GET /datasetsv2/{datasetId}

`GET /datasetsv2/{datasetId}`

Returns information about a Dataset.

## Path parameters

- `datasetId` string, required — 1 - 255 character String

## Response `200`

Success

- GetDatasetResponse — Response for the GetDataset operation
  - `datasetId` string — The unique identifier for a Dataset.
  - `datasetArn` string — The ARN identifier of the Dataset.
  - `datasetTitle` string — Display title for a Dataset.
  - `kind` 'TABULAR' | 'NON_TABULAR' — <p>The format in which Dataset data is structured.</p> <ul> <li> <p> <code>TABULAR</code> – Data is structured in a tabular format.</p> </li> <li> <p> <code>NON_TABULAR</code> – Data is structured in a non-tabular format.</p> </li> </ul>
  - `datasetDescription` string — A description of the Dataset.
  - `createTime` integer — The timestamp at which the Dataset 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 the Dataset 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.
  - `schemaDefinition` object — Definition for a schema on a tabular Dataset.
    - `tabularSchemaConfig` object — The configuration for a schema on a tabular Dataset.
      - `columns` ColumnDefinition[] — List of column definitions.
        - `dataType` 'STRING' | 'CHAR' | 'INTEGER' | 'TINYINT' | 'SMALLINT' | 'BIGINT' | 'FLOAT' | 'DOUBLE' | 'DATE' | 'DATETIME' | 'BOOLEAN' | 'BINARY' — <p>Data type of a column.</p> <ul> <li> <p> <code>STRING</code> – A String data type.</p> <p> <code>CHAR</code> – A char data type.</p> <p> <code>INTEGER</code> – An integer data type.</p> <p> <code>TINYINT</code> – A tinyint data type.</p> <p> <code>SMALLINT</code> – A smallint data type.</p> <p> <code>BIGINT</code> – A bigint data type.</p> <p> <code>FLOAT</code> – A float data type.</p> <p> <code>DOUBLE</code> – A double data type.</p> <p> <code>DATE</code> – A date data type.</p> <p> <code>DATETIME</code> – A datetime data type.</p> <p> <code>BOOLEAN</code> – A boolean data type.</p> <p> <code>BINARY</code> – A binary data type.</p> </li> </ul>
        - `columnName` string — The name of a column.
        - `columnDescription` string — Description for a column.
      - `primaryKeyColumns` ColumnName[] — List of column names used for primary key.
  - `alias` string — The unique resource identifier for a Dataset.
  - `status` 'PENDING' | 'FAILED' | 'SUCCESS' | 'RUNNING' — <p>Status of the Dataset creation.</p> <ul> <li> <p> <code>PENDING</code> – Dataset is pending creation.</p> </li> <li> <p> <code>FAILED</code> – Dataset creation has failed.</p> </li> <li> <p> <code>SUCCESS</code> – Dataset creation has succeeded.</p> </li> <li> <p> <code>RUNNING</code> – Dataset creation is running.</p> </li> </ul>

## Other responses

- `480` — InternalServerException
- `481` — ValidationException
- `482` — ThrottlingException
- `483` — AccessDeniedException
- `484` — ResourceNotFoundException
- `485` — 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)