---
title: "Retrieve"
method: GET
path: "/evaluations/{evaluator_id}/"
tags: ["evaluations"]
---

# Retrieve

`GET /evaluations/{evaluator_id}/`

Get, update, or delete an evaluator's draft version.

GET /api/evaluators/{evaluator_id}/ - Get draft version (is_read_only=False)
PATCH /api/evaluators/{evaluator_id}/ - Update draft version
DELETE /api/evaluators/{evaluator_id}/ - Delete ALL versions

Superadmin: Can READ any evaluator across all organizations via JWT.
            Cannot WRITE via JWT - must use API key for write operations.
Regular users: Can only access evaluators in their organization.

NOTE: Queryset filters by is_read_only=False, ensuring unique lookup per evaluator_id.
This allows DRF's standard get_object() to work without manual overrides.
Delete removes ALL versions of the evaluator.

Defense-in-depth:
- SuperAdminMixin: Queryset routing + JWT write protection + object-level ownership

## Path parameters

- `evaluator_id` string, required

## Headers

- `Authorization` string, required

## Response `200`

- PublicEvaluatorDetail — User-friendly serializer for evaluator detail view via API.
  - `version_id` string
  - `configurations` object
  - `categorical_choices` object[]
  - `score_config` object
  - `passing_conditions` object, nullable
  - `llm_config` object, nullable
  - `code_config` object, nullable
  - `project` string, nullable
  - `is_public` boolean, required
  - `eval_class` string
  - `created_by` Editor, required
    - `id` integer, required
    - `email` string, required
    - `name` string, required
    - `username` string
    - `first_name` string
    - `last_name` string
  - `updated_by` Editor, required
    - `id` integer, required
    - `email` string, required
    - `name` string, required
    - `username` string
    - `first_name` string
    - `last_name` string
  - `editor` Editor, required
    - `id` integer, required
    - `email` string, required
    - `name` string, required
    - `username` string
    - `first_name` string
    - `last_name` string
  - `id` string
  - `version` integer
  - `is_read_only` boolean
  - `version_description` string
  - `evaluator_slug` string
  - `name` string, required
  - `description` string
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `type` 'llm' | 'code' | 'human' | 'function' | 'human_numerical' | 'human_categorical' | 'human_boolean' | 'human_text' | 'custom' — * `llm` - Llm * `code` - Code * `human` - Human * `function` - Function * `human_numerical` - Human Numerical * `human_categorical` - Human Categorical * `human_boolean` - Human Boolean * `human_text` - Human Text * `custom` - Custom
  - `score_value_type` 'numerical' | 'boolean' | 'percentage' | 'single_select' | 'multi_select' | 'text' | 'json' | 'comment' | 'categorical' — * `numerical` - Numerical * `boolean` - Boolean * `percentage` - Percentage * `single_select` - Single Select * `multi_select` - Multi Select * `text` - Text * `json` - Json * `comment` - Comment * `categorical` - Categorical
  - `custom_required_fields` string[]
  - `starred` boolean

---

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