---
title: "Get a dataset by ID"
method: GET
path: "/api/v1/datasets/{dataset_id}"
tags: ["Dataset"]
---

# Get a dataset by ID

`GET /api/v1/datasets/{dataset_id}`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/adaptionlabs/apis/adaption-api/docs/api/v1/datasets/:dataset_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `dataset_id` string, required

## Response `default`

- PublicDatasetDto
  - `dataset_id` string, required: Unique dataset identifier
  - `kind` 'uploaded' | 'combined' | 'invented' | 'augmented' | 'translated' | 'localized' | 'extended', nullable, required: How this dataset came about. `uploaded` was supplied by you, `combined` merges several datasets, `invented` was generated from a prompt, `augmented` adds rows retrieved from the curated pool to another dataset, `translated` / `localized` add translated copies of another dataset’s rows, and `extended` adds a next user turn to each of another dataset’s conversations.
  - `source_dataset_id` string, nullable, required: The dataset this one was derived from. Set when `kind` is `augmented`, `translated`, `localized` or `extended`. Null for `uploaded` and `invented`, and for `combined`, which has several sources rather than one.
  - `name` string, nullable, required: Human-readable name for the dataset
  - `status` 'pending' | 'running' | 'succeeded' | 'failed', required: Lifecycle status: pending, running, succeeded, or failed
  - `created_at` string, date-time, required: Timestamp when the dataset was created
  - `created_by_user_id` string, uuid, nullable, required: User who created the dataset
  - `updated_at` string, date-time, required: Timestamp of the last update
  - `row_count` integer, nullable, required: Total number of rows in the dataset
  - `configured_column_mapping` PublicDatasetColumnMappingDto, required
    - `prompt` string, nullable, required
    - `completion` string, nullable, required
    - `chat` string, nullable, required
    - `context` string[], required
    - `image` string, nullable, required
  - `evaluation_summary` PublicDatasetEvaluationSummaryDto, required
    - `grade_before` string, nullable, required: Letter grade (A-E) before adaptation
    - `grade_after` string, nullable, required: Letter grade (A-E) after adaptation
    - `score_before` number, nullable, required: Quality score before adaptation
    - `score_after` number, nullable, required: Quality score after adaptation
    - `improvement_percent` number, nullable, required: Relative improvement percentage
  - `run_id` string, nullable, required: ID of the currently active run
  - `progress` PublicDatasetProgressDto, required
    - `percent` integer, nullable, required: Progress percentage (0-100)
    - `processed_rows` integer, nullable, required: Number of rows processed so far
    - `total_rows` integer, nullable, required: Total rows to process (samples_to_process or row_count)
  - `error_data` PublicDatasetErrorDataDto, required
    - `message` string, nullable, required: Error message
    - `code` string, nullable, required: Stable error code when the failure was structured (e.g. E0100)
    - `level` 'error' | 'warning', nullable, required: Severity when known
  - `image_column_formats` object, nullable, required: Per-column export encoding for detected image columns (column name → format). Use with `GET /datasets/{dataset_id}/download`: look up the active image column (mapped image column that is also in `configured_column_mapping.context`) to determine how each row's `original_image` is encoded. Null or empty when no image columns were detected.

## Changes

- **2026-10-20** `7398ff1eeeba`: 1 warning
  - added the new `extended` enum value to the `kind` response property for the response status `default`

[Operation history](https://skmtc.dev/adaptionlabs/apis/adaption-api/changes/api/v1/datasets/:dataset_id/get.md)

---

[API](https://skmtc.dev/adaptionlabs/apis/adaption-api.md) - [All operations](https://skmtc.dev/adaptionlabs/apis/adaption-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adaptionlabs/apis/adaption-api/revisions/d4cf908c19a0?raw)