Skip to main content
GET
Get evaluator

Authorizations

Authorization
string
header
required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Path Parameters

evaluator_id
string
required

The unique evaluator identifier (base64) A universally unique identifier (base64-encoded opaque string).

Example:

"RW50aXR5OjEyMzQ1"

Query Parameters

version_id
string

Return the evaluator with this specific version (base64 identifier (base64)). If omitted, returns the latest version. A universally unique identifier (base64-encoded opaque string).

Example:

"RW50aXR5OjEyMzQ1"

Response

Returns an evaluator with a resolved version

An evaluator defines reusable evaluation logic that can be attached to evaluation tasks. The type field determines the kind of evaluation: TEMPLATE (LLM-based template evaluation), CODE (custom code evaluation), REMOTE (externally hosted evaluation), or DECISION_JUDGE (typed questions answered by a Decision Judge model).

id
string
required

The unique identifier for the evaluator

name
string
required

The name of the evaluator

type
enum<string>
required

The evaluator type:

  • TEMPLATE — LLM-based evaluator.
  • CODE — managed built-in evaluators or custom Python code (both are subtypes of CODE, discriminated by the nested CodeConfig.type = MANAGED | CUSTOM).
  • HARNESS — test harness evaluator.
  • REMOTE — remote evaluator.
  • DECISION_JUDGE — Decision Judge evaluator. It asks a set of typed questions about each span and writes one result per question. Requires Decision Judge to be enabled for the account. GET /v2/evaluators returns these evaluators only when type=DECISION_JUDGE is passed.

Applies to both the parent Evaluator.type field and every version's type discriminator — a version's type must always match its parent evaluator's type.

Available options:
TEMPLATE,
CODE,
HARNESS,
REMOTE,
DECISION_JUDGE
space_id
string
required

The unique identifier for the space the evaluator belongs to

created_at
string<date-time>
required

When the evaluator was created

updated_at
string<date-time>
required

When the evaluator was last updated

created_by_user_id
string | null
required

The unique identifier for the user who created the evaluator

version
object
required

The resolved version of the evaluator

description
string | null

The description of the evaluator