---
title: "Get all evaluations"
method: GET
path: "/evaluations"
tags: ["Evaluations"]
---

# Get all evaluations

`GET /evaluations`

Retrieves a complete list of all evaluations with their associated datasets, skills, models, and historical evaluation runs

## Response `200`

Successfully retrieved all evaluations

- object
  - `evaluations` Evaluation[]
    - `_id` string, required — Unique identifier for the evaluation
    - `updatedAt` string, date-time, required — Timestamp of the last update
    - `createdAt` string, date-time, required — Timestamp of creation
    - `name` string, required — Name of the evaluation
    - `comment` string — Optional comment or description for the evaluation
    - `nb_questions` integer, required — Total number of questions in the evaluation
    - `score` number, float, required — Overall score of the evaluation (percentage)
    - `progress` number, float, required — Completion progress (percentage)
    - `status` 'in progress' | 'terminated' | 'pending' | 'failed', required — Current status of the evaluation
    - `model` Model, required — AI model information used for the evaluation
      - `_id` string, required — Unique identifier for the model
      - `provider` string, required — AI model provider name
      - `name` string, required — Short name of the model
      - `model_name` string, required — Full descriptive name of the model
    - `dataset` Dataset, required — Dataset used for the evaluation
      - `_id` string, required — Unique identifier for the dataset
      - `name` string, required — Name of the dataset
    - `skill` Skill, required — Bot skill being evaluated
      - `_id` string, required — Unique identifier for the skill
      - `name` string, required — Name of the skill
    - `evals` object — Historical evaluation runs with their IDs as keys
    - `data_length` integer, required — Length of the dataset used

## Other responses

- `400` — Invalid request
- `401` — Unauthorized - Invalid or missing authentication
- `500` — Internal server error

---

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