---
title: "Get evaluation by ID"
method: GET
path: "/evaluations/{evaluation_id}"
tags: ["Evaluations"]
---

# Get evaluation by ID

`GET /evaluations/{evaluation_id}`

Returns detailed information of a specific evaluation

## Path parameters

- `evaluation_id` string, required

## Response `200`

Successfully retrieved evaluation

- object
  - `evaluation` EvaluationDetails — Detailed evaluation object returned after creation or restart
    - `_id` string, required — Unique identifier for the evaluation
    - `name` string, required — Name of the evaluation
    - `data` object[] — Evaluation data (empty at creation)
    - `user_id` string, required — ID of the user who created the evaluation
    - `skill` object, required — Skill/bot being evaluated
      - `_id` string
      - `name` string
    - `dataset` object, required — Dataset used for evaluation
      - `_id` string
      - `name` string
    - `model` object, required — AI model used for evaluation
      - `_id` string
      - `name` string
      - `model_name` string
      - `provider` string
    - `status` 'in progress' | 'terminated' | 'pending' | 'failed', required — Current status of the evaluation
    - `progress` number, float, required — Completion progress (percentage)
    - `score` number, float, required — Current score (percentage)
    - `nb_questions` integer, required — Total number of questions
    - `is_child` boolean, required — Indicates if this is a restarted evaluation (child of original)
    - `comment` string — Comment or description
    - `custom_instructions` string — Custom instructions for the AI model
    - `createdAt` string, date-time, required — Creation timestamp
    - `updatedAt` string, date-time, required — Last update timestamp
    - `__v` integer — Version key

## Other responses

- `400` — Invalid ID supplied
- `401` — Unauthorized - Invalid or missing authentication
- `404` — Evaluation not found

---

[API](https://skmtc.net/smartly/apis/smartly-ai-apis.md) · [All operations](https://skmtc.net/smartly/apis/smartly-ai-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartly/smartly-ai-apis/revisions/1e26909d86c9/schema)