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

​
Overview

Retrieves a paginated list of judges with optional filtering by content type and status.

​
Query Parameters

​
limit
integer
default:"50"
Number of judges to return (max 100)
​
offset
integer
default:"0"
Number of judges to skip
​
content_type
string
Filter by content type (text, video, audio, image)
​
status
string
Filter by status (ready, learning, training)

​
Response

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

​
Examples

curl -X GET "https://api.judge.example.com/judges?limit=20&content_type=text" \
  -H "Authorization: Bearer YOUR_API_KEY"