---
title: "Get the processing status of a dataset"
method: GET
path: "/api/v1/datasets/{dataset_id}/status"
tags: ["Dataset"]
---

# Get the processing status of a dataset

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

## Request

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

## Path parameters

- `dataset_id` string, required

## Response `default`

- PublicDatasetStatusResponseDto
  - `dataset_id` string, required: Dataset ID
  - `status` 'pending' | 'running' | 'awaiting_input' | 'succeeded' | 'failed', required: Current processing status. `awaiting_input` means the dataset is uploaded but waiting for you to start adaptation via datasets.adapt(column_mapping=...) — it will not progress on its own. An uploaded document dataset with no `row_count` yet is instead waiting for POST /datasets/{dataset_id}/launch-preprocessing.
  - `row_count` integer, nullable, required: Number of rows in the dataset
  - `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

---

[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)