Skip to main content
GET
/
batches
{
  "batches": [
    {}
  ],
  "total": 123,
  "has_more": true,
  "limit": 123,
  "offset": 123
}

​
Overview

Retrieves a paginated list of batch evaluation jobs with optional filtering.

​
Query Parameters

​
limit
integer
default:"50"
Number of batches to return (max 100)
​
offset
integer
default:"0"
Number of batches to skip
​
status
string
Filter by status (created, evaluating, completed, failed)
​
judge_id
string
Filter by judge ID
​
since
datetime
Filter batches created after this timestamp

​
Response

​
batches
array
required
Array of batch objects
​
total
integer
required
Total number of batches
​
has_more
boolean
required
Whether more batches are available
​
limit
integer
Number returned
​
offset
integer
Number skipped

​
Examples

curl -X GET "https://api.judge.example.com/batches?limit=20&status=completed" \
  -H "Authorization: Bearer YOUR_API_KEY"