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

---

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