---
title: "List evaluator versions"
method: GET
path: "/api/evaluators/{evaluator_id}/versions/"
tags: ["evaluators"]
---

# List evaluator versions

`GET /api/evaluators/{evaluator_id}/versions/`

List all versions of an evaluator, ordered newest first. Version `0` is the initial draft; committed versions are returned with `is_read_only: true`.

## Path parameters

- `evaluator_id` string, required

## Query parameters

- `page` integer
- `page_size` integer

## Headers

- `Authorization` string, required

## Response `200`

Paginated evaluator versions.

- EvaluatorsListEvaluatorVersionsResponse200
  - `count` integer, required — Number of resources returned on this page.
  - `next` string, nullable — URL for the next page, if any.
  - `previous` string, nullable — URL for the previous page, if any.
  - `current_filters` ApiEvaluatorsEvaluatorIdVersionsGetResponsesContentApplicationJsonSchemaCurrentFilters — Normalized filters applied to this request.
  - `results` ApiEvaluatorsEvaluatorIdVersionsGetResponsesContentApplicationJsonSchemaResultsItems[], required
    - `id` string, required — Stable evaluator ID shared by all versions.
    - `version_id` string, required — Unique ID for this evaluator version.
    - `version` integer, required — Version number. The first draft is version 0.
    - `is_read_only` boolean, required — Whether this version is committed and immutable.
    - `version_description` string — Commit message for this version.
    - `name` string, required
    - `description` string, nullable
    - `type` 'llm' | 'human' | 'code', required
    - `score_value_type` 'numerical' | 'boolean' | 'percentage' | 'single_select' | 'multi_select' | 'text' | 'json' | 'comment' | 'categorical', required
    - `created_at` string, date-time
    - `created_by` ApiEvaluatorsEvaluatorIdVersionsGetResponsesContentApplicationJsonSchemaResultsItemsCreatedBy
      - `id` integer
      - `first_name` string
      - `last_name` string
      - `email` string, email

## Other responses

- `401` — Unauthorized - Missing or invalid authentication
- `404` — Not Found

## Changes

- **2026-08-22** `b18c72975097` — 3 warning
  - for the `query` request parameter `page_size`, the max was set to `100.00`
  - for the `query` request parameter `page`, the min was set to `1.00`
  - for the `query` request parameter `page_size`, the min was set to `1.00`
- **2026-08-13** `4e064cf81dae` — 8 breaking, 3 warning, 14 info
  - the response property `results/items/description` became nullable for the status `200`
  - the response property `results/items/created_at` became optional for the status `200`
  - the response property `results/items/created_by` became optional for the status `200`
  - the response property `results/items/created_by/email` became optional for the status `200`
  - …21 more
- **2026-07-31** `c26d550029f8` — 9 breaking, 6 warning, 10 info
  - the response property `results/items/id` became optional for the status `200`
  - the response property `results/items/is_read_only` became optional for the status `200`
  - the response property `results/items/score_value_type` became optional for the status `200`
  - the response property `results/items/type` became optional for the status `200`
  - …21 more

[Change history](https://skmtc.dev/keywordsai/apis/api-reference/changes/api/evaluators/:evaluator_id/versions/get.md)

---

[API](https://skmtc.dev/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.dev/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/c61efaf24756/schema)