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

# List Datasets

`GET /v1/datasets`

This endpoint returns a list of configured datasets. The response can be formatted as **JSON** or **CSV**,
and additional filters can be applied using query parameters.

## Query parameters

- `status` boolean
- `format` 'json' | 'csv'
- `source` string, nullable

## Response `200`

List of datasets

- DatasetResponseItem
  - `acceleration_enabled` boolean, required — Whether acceleration is enabled for the dataset
  - `from` string, required — The source where the dataset is located
  - `name` string, required — The name of the dataset
  - `properties` object — Custom properties for the dataset
  - `replication_enabled` boolean, required — Whether replication is enabled for the dataset
  - `status` 'Initializing' | 'Ready' | 'Disabled' | 'Error' | 'Refreshing' | 'ShuttingDown' — Represents the status of a component (e.g. dataset, model, etc).

## Other responses

- `500` — Internal server error occurred while processing datasets

## Changes

- **2025-03-18** `dd94571fef79` — 1 breaking, 2 warning, 1 info
  - added `#/components/schemas/ComponentStatus` to the `status` response property `oneOf` list for the response status `200` (media type: application/json)
  - removed the optional property `error` from the response with the `200` status (media type: application/json)
  - removed the optional property `error_message` from the response with the `200` status (media type: application/json)
  - removed `#/components/schemas/String` from the `status` response property `oneOf` list for the response status `200` (media type: application/json)

[Change history](https://skmtc.dev/spiceai/apis/runtime/changes/v1/datasets/get.md)

---

[API](https://skmtc.dev/spiceai/apis/runtime.md) · [All operations](https://skmtc.dev/spiceai/apis/runtime/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spiceai/runtime/revisions/dd94571fef79/schema)