Skip to main content
POST
Judge Catalog Rows

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Organization-Id
string | null

Body

application/json

Request to judge catalog rows. Pulls schema + quality_prompt from catalog when catalog_id is provided.

For multimodal judging (e.g. verifying images match product data), pass images as a dict mapping row index (string) to a list of image URLs. When images are present the judge uses a vision model automatically.

rows
Rows · object[]
required

Rows to evaluate

catalog_id
string | null

Catalog ID — fetches schema and quality_prompt automatically

schema
Schema · object | null

Inline schema (only needed if no catalog_id)

prompt
string | null

Extra instructions (appended to catalog's quality_prompt if present)

model
string
default:fast

Model preset: fast, medium, high

max_rows
integer
default:200

Max rows to judge per request

Required range: 1 <= x <= 500
images
Images · object | null

Explicit image URLs per row index, e.g. {"0": ["https://..."]}

Response

Successful Response

Row-level quality judgments.

judgments
Judgments · object[]

Per-row judgments from the LLM

meta
Meta · object

Model, row counts, etc.