Skip to main content
GET
/
batches
/
{batch_id}
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "status": "<string>",
  "judge_ids": [
    {}
  ],
  "content_ids": [
    {}
  ],
  "total_evaluations": 123,
  "completed_evaluations": 123,
  "failed_evaluations": 123,
  "progress_percentage": 123,
  "results_summary": {
    "average_score": 123,
    "score_distribution": {}
  },
  "created_at": {},
  "completed_at": {}
}

​
Overview

Retrieves detailed information about a batch job including progress and results.

​
Path Parameters

​
batch_id
string
required
The unique identifier of the batch

​
Response

​
id
string
required
Batch identifier
​
name
string
required
Batch name
​
description
string
Batch description
​
status
string
required
Current status (created, evaluating, completed, failed)
​
judge_ids
array
required
Array of judge IDs used
​
content_ids
array
required
Array of content IDs being evaluated
​
total_evaluations
integer
required
Total evaluations to perform
​
completed_evaluations
integer
required
Completed evaluations
​
failed_evaluations
integer
required
Failed evaluations
​
progress_percentage
number
required
Completion percentage (0-100)
​
results_summary
object
Summary of evaluation results
​
created_at
datetime
required
Creation timestamp
​
completed_at
datetime
Completion timestamp

​
Examples

curl -X GET https://api.judge.example.com/batches/batch_def456 \
  -H "Authorization: Bearer YOUR_API_KEY"