---
title: "Get Model Datasets"
method: GET
path: "/analytics/model-datasets"
tags: ["analytics"]
---

# Get Model Datasets

`GET /analytics/model-datasets`

Return training + evaluation datasets for a project or base model.

Exactly one of ``project_id`` or ``base_model`` must be provided.

Args:
    project_id: Scope to datasets directly attached to this project,
        or the sentinel ``"default"`` for unallocated datasets.
    base_model: Scope to datasets used by training jobs and
        evaluations against this base model id.
    auth: Authentication result carrying the user id and team scope.

Returns:
    ``ModelDatasetsResponse`` with training and evaluation dataset
    rows. Evaluation rows include their latest completed evaluation
    when available.

## Query parameters

- `project_id` string, nullable — Project UUID. Returns datasets attached to this project. Pass the literal value 'default' to return datasets whose project_id is null (the unallocated-resources bucket).
- `base_model` string, nullable — Base catalog model id (e.g. 'meta-llama/Llama-3-8B').

## Response `200`

Successful Response

- ModelDatasetsResponse — Datasets scoped to either a project or a base model. Training rows come from ``datasets.type = 'training'``; evaluation rows come from ``datasets.type IN ('evaluation', 'benchmark')`` and carry their most recent completed evaluation against the model.
  - `training_datasets` TrainingDatasetRow[]
    - `id` string, required
    - `dataset_name` string, required
    - `version_number` string, required
    - `dataset_type` string, nullable — Domain type of the dataset (ner, classification, custom, decoder).
    - `generation_type` string, nullable — How the dataset was created: synthesize, upload, auto_relabel, manual_relabel, grow, external.
    - `sample_size` integer, nullable
    - `updated_at` string, date-time, nullable
  - `evaluation_datasets` EvaluationDatasetRow[]
    - `id` string, required
    - `dataset_name` string, required
    - `version_number` string, required
    - `dataset_type` string, nullable — Domain type of the dataset (ner, classification, custom, decoder).
    - `generation_type` string, nullable — How the dataset was created: synthesize, upload, auto_relabel, manual_relabel, grow, external.
    - `sample_size` integer, nullable
    - `updated_at` string, date-time, nullable
    - `latest_evaluation` DatasetEvaluationSummary — Latest evaluation attached to an evaluation dataset row. Used on the Datasets tab to surface the most recent pass-rate / loss for a given evaluation dataset against the model in context.
      - `evaluation_id` string, required
      - `accuracy` number, nullable
      - `f1_score` number, nullable
      - `sample_count` integer, nullable
      - `completed_at` string, date-time, nullable

## Other responses

- `400` — Exactly one scope parameter must be provided.
- `422` — Validation Error
- `503` — Model datasets dependency is temporarily unavailable.

---

[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/revisions/31dfe831e079/schema)