Skip to main content
GET
/
v2
/
evaluators
/
{evaluator_id}
/
versions
List evaluator versions
curl --request GET \
  --url https://api.arize.com/v2/evaluators/{evaluator_id}/versions \
  --header 'Authorization: Bearer <token>'
{
  "evaluator_versions": [
    {
      "id": "RXZhbHVhdG9yVmVyc2lvbjoxMDpYeVp3",
      "evaluator_id": "RXZhbHVhdG9yOjEyOmFCY0Q=",
      "commit_hash": "a3b1c9e4f7d2a0518e6c3bb9217f87d1c4e810f2",
      "commit_message": "Initial version",
      "type": "template",
      "template_config": {
        "name": "hallucination",
        "template": "You are an evaluation assistant...",
        "include_explanations": true,
        "use_function_calling_if_available": true,
        "classification_choices": {
          "hallucinated": 0,
          "factual": 1
        },
        "direction": "maximize",
        "data_granularity": "span",
        "llm_config": {
          "ai_integration_id": "TGxtSW50ZWdyYXRpb246MTI6YUJjRA==",
          "model_name": "gpt-4o",
          "invocation_parameters": {
            "temperature": 0
          },
          "provider_parameters": {}
        }
      },
      "created_at": "2026-02-16T22:05:48.143Z",
      "created_by_user_id": "VXNlcjoxOm5OYkM="
    }
  ],
  "pagination": {
    "has_more": false
  }
}

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

​
limit
integer
default:50

Maximum items to return

Required range: 1 <= x <= 100
​
cursor
string

Opaque pagination cursor returned from a previous response (pagination.next_cursor). Treat it as an unreadable token; do not attempt to parse or construct it.

Response

Returns a list of evaluator version objects

​
evaluator_versions
object[]
required

A list of evaluator versions

A versioned snapshot of an evaluator's configuration. Exactly one of template_config or code_config is present. The type field discriminates the branch and matches the parent evaluator's type.

​
pagination
object
required

Pagination metadata for cursor-based navigation