List Judges

Authentication

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

Overview

Returns a paginated list of all judges belonging to your organization. Judges are sorted by creation date (newest first).

Query Parameters

limit

integer

default:"50"

Maximum number of judges to return per page.Range: 1-100

offset

integer

default:"0"

Number of judges to skip for pagination.Minimum: 0

content_type

string

Filter judges by content type.Allowed values: video, image

Request Example

cURL

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

With Pagination

curl -X GET "https://api.getpique.ai/v1/judges?limit=10&offset=0" \
  -H "X-API-Key: pk_your_api_key_here"

With Content Type Filter

curl -X GET "https://api.getpique.ai/v1/judges?content_type=video" \
  -H "X-API-Key: pk_your_api_key_here"

Response

judges

array

Array of judge objects

Show Judge Object

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

Show Detector Config

string

Unique identifier for the detector configuration

detector_name

string

Name of the detector

config

object

Configuration parameters for the detector

weight

integer

Weight of this detector in scoring (1-10)

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

total

integer

Total number of judges matching the query

has_more

boolean

Whether there are more judges available beyond the current page

Response Example

{
  "judges": [
    {
      "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"
    }
  ],
  "total": 1,
  "has_more": false
}

API Documentation

Judges

Detectors

Evaluations

Authentication

Overview

Query Parameters

Request Example

cURL

With Content Type Filter

Response

Response Example

Error Responses

401 Unauthorized

500 Internal Server Error

API Documentation

Judges

Detectors

Evaluations

​Authentication

​Overview

​Query Parameters

​Request Example

​cURL

​With Pagination

​With Content Type Filter

​Response

​Response Example

​Error Responses

​401 Unauthorized

​500 Internal Server Error

Authentication

Overview

Query Parameters

Request Example

cURL

With Pagination

With Content Type Filter

Response

Response Example

Error Responses

401 Unauthorized

500 Internal Server Error