---
title: "List datasets (Deprecated)"
method: GET
path: "/v2/datasets"
tags: ["Datasets"]
---

# List datasets (Deprecated)

`GET /v2/datasets`

## Request

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

Get a list of available datasets. Available datasets include any datasets in your My Documents folder and any datasets you have access to.

 **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 **ownerId** by calling the [/v2/members](/reference/list-members) endpoint and using the `memberId` included in the response.

 ### Usage scenarios
 - **Plan dataset migration**: Review the owner, location (path) of the dataset, migration status, and total number of documents that reference the dataset to plan dataset migration tasks. Pass `ownerId` to scope results to one owner's datasets.
 - **Clean up after dataset migration**: Retrieve the `dataModelId` of the data model created for the dataset. Make a GET request to the [/v2/dataModels/{dataModelId}](https://help.sigmacomputing.com/reference/get-data-model) endpoint to retrieve more details about the created data model.
 - **Identify unused datasets**: Review datasets that have 0 documents referencing it as a source and delete those datasets by making a DELETE request to the [/v2/files/{inodeId}](https://help.sigmacomputing.com/reference/delete-file) endpoint.

## Query parameters

- `page` string
- `limit` number, double
- `skipPermissionCheck` boolean
- `ownerId` string

## Response `200`

The response body.

- DatasetsListDatasetsResponse200
  - `entries` V2DatasetsGetResponsesContentApplicationJsonSchemaEntriesItems[], required: Array of results returned by the endpoint
    - `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` V2DatasetsGetResponsesContentApplicationJsonSchemaEntriesItemsMigrationToDataModel, 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
  - `nextPage` string, nullable, required: Returns a string that can be used as the `page` parameter in the next request to fetch the next page of results. The last page of results returns `null`.
  - `total` number, double: Total number of results. Useful to determine if there is a need to paginate.
  - `hasMore` boolean: **[Deprecated]** Indicates whether more results are available.

---

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