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

# Get evaluation results for a dataset

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

## Request

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

## Path parameters

- `dataset_id` string, required

## Response `default`

- DatasetEvaluationResponseDto
  - `dataset_id` string, required: Dataset ID
  - `status` string, nullable, required: Evaluation pipeline status: pending | running | succeeded | failed | skipped
  - `quality` EvaluationQualityDto, 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 (0-10) before adaptation
    - `score_after` number, nullable, required: Quality score (0-10) after adaptation
    - `percentile_after` number, nullable, required: Percentile rank (0-100) after adaptation
    - `improvement_percent` number, nullable, required: Relative quality improvement as a percentage
  - `raw_results` object, nullable, required: Raw evaluation results payload for advanced use. Null until evaluation completes.

---

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