---
title: "Get a dataset (Deprecated)"
method: GET
path: "/v2/datasets/{datasetId}"
tags: ["Datasets"]
---

# Get a dataset (Deprecated)

`GET /v2/datasets/{datasetId}`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/datasets/{datasetId}`
- Auth: HTTP bearer

Get a specific dataset by datasetId

  **Deprecation notice**: [Datasets](/docs/datasets) are deprecated. As of June 2, 2026, you can no longer create datasets or edit existing datasets. As of September 15, 2026, you can no longer use datasets as a data source. Migrate your datasets to data models and update any documents that use datasets as a data source to use a different source. See [Migrate a dataset to a data model](/docs/migrate-a-dataset-to-a-data-model).

  ### Usage notes
  - Retrieve the **datasetId** by calling the [/v2/datasets](https://help.sigmacomputing.com/reference/list-datasets) endpoint.

## Path parameters

- `datasetId` string, required

## Response `200`

The response body.

- DatasetsGetDatasetResponse200
  - `datasetId` string, required
  - `createdBy` string, required
  - `updatedBy` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `name` string, required
  - `description` string, required
  - `url` string, required
  - `owner` string, required
  - `referenceCount` number, double, required: Count of inbound references to the dataset
  - `path` string, required: Path describing dataset's ancestor workspace and folders
  - `migrationToDataModel` V2DatasetsDatasetIdGetResponsesContentApplicationJsonSchemaMigrationToDataModel, required: Details about migration to data model
    - `dataModelId` string, required
    - `dataModelUrl` string, required
    - `migratedAt` string, date-time, required
    - `migratedBy` string, required
  - `migrationStatus` 'migrated' | 'not-migrated' | 'not-required', required: An indicator of the dataset's migration status as displayed on the dataset migration admin page. - `not-required` indicates that the dataset is not used as a data source (in other words, it is not referenced by other documents) and likely does not need to be migrated to a data model. - `migrated` indicates that the dataset has already been migrated to a data model - `not-migrated` indicates that the dataset has not been migrated and is still in use as a data source
  - `isArchived` boolean

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)