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

Documentation Index

Fetch the complete documentation index at: https://arize-ax.mintlify.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

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 evaluator global ID (base64) A universally unique identifier

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