Skip to main content
GET
/
api-key
/
judges
{
  "judges": [
    {
      "judge_id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "content_type": "<string>",
      "status": "<string>",
      "criteria_count": 123,
      "created_at": {},
      "version_number": 123
    }
  ],
  "total_count": 123
}

Overview

Retrieves a list of judges accessible to your organization using API key authentication.

Headers

X-API-Key
string
required
Organization API key for authentication

Query Parameters

status
string
Filter by judge status (ready, learning, training)
content_type
string
Filter by content type (text, video, audio, image)
limit
integer
default:"25"
Maximum number of judges to return

Response

judges
array
required
List of judges
total_count
integer
required
Total number of judges (for pagination)

Examples

curl -X GET "https://api.judge.example.com/api-key/judges?status=ready&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"