Skip to main content
Get Judge
curl --request GET \
  --url https://api.getpique.ai/v1/judges/{judge_id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "content_type": "<string>",
  "status": "<string>",
  "detector_configs": [
    {
      "id": "<string>",
      "detector_name": "<string>",
      "config": {},
      "weight": 123
    }
  ],
  "is_active": true,
  "created_at": "<string>",
  "updated_at": "<string>"
}

​
Authentication

Required: API Key authentication via X-API-Key header

​
Overview

Returns detailed information about a specific judge, including all detector configurations.

​
Path Parameters

​
judge_id
string
required
The unique identifier of the judge to retrieve

​
Request Example

​
cURL

curl -X GET "https://api.getpique.ai/v1/judges/<judge_id>" \
  -H "X-API-Key: pk_your_api_key_here"

​
Response

​
id
string
Unique identifier for the judge
​
name
string
The name of the judge
​
description
string
Description of what this judge evaluates
​
content_type
string
The type of content this judge evaluates (video or image)
​
status
string
Current status of the judgePossible values:
  • ready - Judge is ready to use
  • pending - Judge is being prepared
  • failed - Judge creation failed
​
detector_configs
array
Array of detector configurations attached to this judge
​
is_active
boolean
Whether the judge is currently active
​
created_at
string
ISO 8601 timestamp of when the judge was created
​
updated_at
string
ISO 8601 timestamp of when the judge was last updated

​
Response Example

{
  "id": "1f46ff19-e251-421c-8b81-30561e160b62",
  "name": "Brand Video Judge",
  "description": "Evaluates brand video content for compliance and quality",
  "content_type": "video",
  "status": "ready",
  "detector_configs": [
    {
      "id": "443b224d-d5af-40bd-95cb-ec54ea9dacf6",
      "detector_name": "language",
      "config": {
        "accepted_languages": ["en"]
      },
      "weight": 5
    },
    {
      "id": "f08eedc2-cb03-43cf-a041-84b0c6b91ae0",
      "detector_name": "subtitles",
      "config": {
        "require_subtitles": true
      },
      "weight": 5
    },
    {
      "id": "6f17c1d8-27bd-492e-9117-b272446d9e19",
      "detector_name": "title_and_description",
      "config": {
        "required_hashtags": ["#acme"]
      },
      "weight": 5
    },
    {
      "id": "d9104e0a-fa8d-4dfe-aedb-54e1ae255646",
      "detector_name": "video_matching",
      "config": {
        "reference_videos": [
          "gs://judge-artifacts-sandbox/org_9094b441/reference_uploads/c354b125/f37ba7ed.mp4"
        ]
      },
      "weight": 5
    },
    {
      "id": "9319a5b2-c4f5-46a3-9664-443fb8db4d3c",
      "detector_name": "video_specs",
      "config": {
        "min_width": 1080,
        "min_height": 1080,
        "min_duration_sec": 10,
        "allowed_aspect_ratios": ["9:16", "4:3"]
      },
      "weight": 5
    }
  ],
  "is_active": true,
  "created_at": "2026-01-22T05:33:07.965372Z",
  "updated_at": "2026-01-25T23:40:28.563145Z"
}

​
Error Responses

​
401 Unauthorized

Missing or invalid API key

​
404 Not Found

Judge not found or not accessible by your organization

​
500 Internal Server Error

Failed to retrieve judge due to server error