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

# List Datasets

`GET /felix/datasets`

List all datasets for the authenticated user.

By default, returns only the latest version of each dataset.
Set include_all_versions=True to return all versions.
If project_id is provided, returns datasets for that project plus orphan datasets.

Failed datasets (status='failed') are hidden from the default
response. They are preserved in the database — the raw upload,
``processing_error``, and ``column_mapping`` columns stay populated
so support tooling can replay or inspect them.

Pass ``include_failed=true`` to surface the caller's own failed
rows (e.g. for an "uploads" / "history" view that wants to show
error details). The flag is purely a result-set toggle — it does
not relax the user-scoping that runs underneath, so it's safe for
any authenticated caller. There is intentionally no admin-only
gate; if cross-user visibility is ever needed it should be a
separate, explicitly-authenticated endpoint.

## Query parameters

- `include_all_versions` boolean
- `project_id` string, nullable — Filter by project ID (includes datasets with no project)
- `include_failed` boolean — When true, include the caller's own failed datasets (status='failed'). Defaults to false so the UI never renders broken-but-clickable records that 404 on preview/analyze. The result set is always scoped to the authenticated user — this flag does NOT grant cross-user visibility, so passing true is safe for any authenticated caller. Failed rows remain in the database for support / debugging; their original upload is preserved at raw_s3_key.

## Response `200`

Successful Response

- DatasetListResponse — Response model for listing datasets.
  - `success` boolean
  - `datasets` DatasetResponse[], required
    - `id` string, required
    - `user_id` string, required
    - `dataset_name` string, required
    - `dataset_path` string, required
    - `dataset_type` string, required
    - `size` integer, nullable
    - `sample_size` integer, nullable
    - `train_ratio` number, nullable — Train split ratio for this dataset version. Left-to-right split with no shuffle; validation is the tail.
    - `created_at` string, required
    - `updated_at` string, required
    - `version_number` string
    - `root_dataset_id` string, nullable
    - `project_id` string, nullable
    - `schema` object, nullable
    - `schema_warnings` string[], nullable
    - `validation` object, nullable
    - `annotation_status` 'none' | 'in_progress' | 'completed', nullable
    - `annotation_config` object, nullable
    - `annotation_progress` object, nullable
    - `status` 'initialized' | 'uploading' | 'converting' | 'validating' | 'ready' | 'failed' | 'generating' | 'queued', nullable — Dataset status: initialized/uploading/converting/validating/ready/failed/generating/queued
    - `processing_error` string, nullable — Error message if status is failed
    - `type` string — Dataset purpose tag: 'training', 'evaluation', or 'benchmark'
    - `visibility` string — Dataset visibility: 'private' or 'public'
    - `is_competition` boolean — Whether this dataset is a competition benchmark
    - `labels` string[], nullable — Label names (entity types for NER, class labels for classification)
    - `generation_type` string, nullable — How the dataset was created: synthesize, upload, auto_relabel, manual_relabel, grow, external
    - `is_seed` boolean, nullable — Whether this dataset is a seed dataset (small set for review before full expansion)
    - `synthesis_session_id` string, nullable — UUID of the synthesis log session for this dataset, used to restore creation workflow on resume
    - `column_mapping` object, nullable — Column mapping from original to standard names
  - `count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/versions/31dfe831e079/schema)