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

# List datasets

`GET /v2/datasets`

List datasets the user has access to.

The datasets are sorted by creation date, with the most recently created
datasets coming first.

The dataset versions are not included in this response. To get the
versions of a specific dataset, use the Get Dataset by ID endpoint.

<Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note>

## Query parameters

- `space_id` string — A universally unique identifier (base64-encoded opaque string).
- `space_name` string
- `name` string
- `limit` integer
- `cursor` string

## Response `200`

Returns a list of dataset objects

- ListDatasetsResponse
  - `datasets` Dataset[], required — A list of datasets
    - `id` string, required — Unique identifier for the dataset
    - `name` string, required — Name of the dataset
    - `space_id` string, required — Unique identifier for the space this dataset belongs to
    - `created_at` string, date-time, required — Timestamp for when the dataset was created
    - `updated_at` string, date-time, required — Timestamp for the last update of the dataset
    - `versions` DatasetVersion[] — List of versions associated with this dataset
      - `id` string, required — Unique identifier for the dataset version
      - `name` string, required — Name of the dataset version
      - `dataset_id` string, required — Unique identifier for the dataset this version belongs to
      - `created_at` string, date-time, required — Timestamp for when the dataset version was created
      - `updated_at` string, date-time, required — Timestamp for the last update of the dataset version
  - `pagination` PaginationMetadata, required — Cursor-based pagination metadata. Use `next_cursor` in the subsequent request's `cursor` query parameter.
    - `next_cursor` string — Opaque cursor for fetching the next page. Treat as an unreadable token. Present when `has_more` is true; omitted when `has_more` is false.
    - `has_more` boolean, required — True if another page of results is available.

## Other responses

- `400` — Invalid request
- `401` — Authentication is required
- `403` — Insufficient permissions to access this resource
- `404` — Not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/arize-ai/apis/arize-rest-api.md) · [All operations](https://skmtc.net/arize-ai/apis/arize-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arize-ai/arize-rest-api/versions/1e87d8a4cf69/schema)