Skip to main content
GET
/
judges
/
{judge_id}
/
versions
{
  "judge_id": "<string>",
  "current_version": 123,
  "total_versions": 123,
  "versions": [
    {
      "version_number": 123,
      "version_id": "<string>",
      "status": "<string>",
      "created_at": {},
      "deployed_at": {},
      "archived_at": {},
      "performance_metrics": {
        "accuracy_score": 123,
        "consistency_score": 123,
        "average_evaluation_time": 123,
        "criteria_performance": {},
        "evaluation_count": 123
      },
      "changes_summary": "<string>",
      "training_info": {
        "training_job_id": "<string>",
        "feedback_count_used": 123,
        "improvements_achieved": [
          {}
        ]
      }
    }
  ]
}

​
Overview

Retrieves the version history for a judge, including all past versions, their performance metrics, and deployment status. This helps track judge evolution and compare different versions.

​
Path Parameters

​
judge_id
string
required
Unique identifier of the judge

​
Query Parameters

​
limit
integer
default:"25"
Maximum number of versions to return
​
offset
integer
default:"0"
Number of versions to skip for pagination
​
include_metrics
boolean
default:"true"
Include performance metrics for each version
​
status_filter
string
Filter versions by status
  • active - Currently active version
  • deployed - Previously deployed versions
  • draft - Draft versions not yet deployed
  • archived - Archived old versions

​
Response

​
judge_id
string
required
ID of the judge
​
current_version
integer
required
Currently active version number
​
total_versions
integer
required
Total number of versions created
​
versions
array
required
List of judge versions

​
Examples

curl -X GET "https://api.judge.example.com/judges/jdg_xyz789/versions?limit=10&include_metrics=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET https://api.judge.example.com/judges/invalid_judge/versions \
  -H "Authorization: Bearer YOUR_API_KEY"