Skip to main content
GET
/
training
/
jobs
/
{job_id}
{
  "job_id": "<string>",
  "judge_id": "<string>",
  "training_type": "<string>",
  "status": "<string>",
  "progress": {
    "current_epoch": 123,
    "total_epochs": 123,
    "epoch_progress": 123,
    "overall_progress": 123,
    "estimated_time_remaining": 123,
    "phase": "<string>"
  },
  "training_config": {},
  "metrics": {
    "training_loss": [
      {}
    ],
    "validation_loss": [
      {}
    ],
    "accuracy_improvement": 123,
    "f1_score": 123,
    "criteria_improvements": {},
    "convergence_info": {
      "converged": true,
      "early_stopped": true,
      "patience_remaining": 123
    }
  },
  "results": {
    "new_model_version": "<string>",
    "performance_comparison": {
      "accuracy_delta": 123,
      "consistency_delta": 123,
      "speed_delta": 123
    },
    "validation_results": {
      "test_accuracy": 123,
      "test_f1_score": 123,
      "criteria_scores": {}
    },
    "deployment_ready": true
  },
  "error_info": {
    "error_code": "<string>",
    "error_message": "<string>",
    "failed_at_epoch": 123,
    "suggested_fixes": [
      {}
    ]
  },
  "created_at": {},
  "started_at": {},
  "completed_at": {},
  "created_by": "<string>"
}

Overview

Retrieves detailed information about a training job, including current status, progress metrics, training results, and performance improvements achieved.

Path Parameters

job_id
string
required
Unique identifier of the training job

Query Parameters

include_metrics
boolean
default:"true"
Include detailed training metrics and performance data
include_logs
boolean
default:"false"
Include training logs (for debugging)
metrics_limit
integer
default:"100"
Maximum number of metric data points to return

Response

job_id
string
required
Unique identifier for the training job
judge_id
string
required
ID of the judge being trained
training_type
string
required
Type of training performed
status
string
required
Current job status
  • created - Job created but not started
  • queued - Job queued for execution
  • preparing - Preparing training data
  • training - Training in progress
  • validating - Validating results
  • completed - Training completed successfully
  • failed - Training failed
  • cancelled - Job was cancelled
progress
object
required
Training progress information
training_config
object
required
Configuration used for training
metrics
object
Training metrics (if include_metrics=true)
results
object
Training results (if job completed)
error_info
object
Error information (if job failed)
created_at
datetime
required
Job creation timestamp
started_at
datetime
Training start timestamp
completed_at
datetime
Job completion timestamp
created_by
string
required
User ID who created the job

Examples

curl -X GET "https://api.judge.example.com/training/jobs/train_job_123?include_metrics=true" \
  -H "Authorization: Bearer YOUR_API_KEY"
curl -X GET https://api.judge.example.com/training/jobs/train_job_456 \
  -H "Authorization: Bearer YOUR_API_KEY"
curl -X GET https://api.judge.example.com/training/jobs/invalid_job \
  -H "Authorization: Bearer YOUR_API_KEY"
curl -X GET https://api.judge.example.com/training/jobs/train_job_failed \
  -H "Authorization: Bearer YOUR_API_KEY"