Runtype APIEvals

List eval batches

List all eval batches for the current user with optional filtering and pagination.

Authentication

AuthorizationBearer
API key or Clerk session token

Query parameters

limitstringOptional

Number of results (default 50, max 100)

offsetstringOptional
Pagination offset
statusstringOptional

Filter by status (queued|processing|completed|failed)

originenumOptional

Filter by run origin: “suite” = runs linked to an eval suite (CI gates, suite Run button); “adhoc” = suite-less runs (ad-hoc config comparisons, legacy evals).

Allowed values:
evalSuiteIdstringOptional

Filter to runs of a specific eval suite. Server-side, so a suite with sparse runs is not crowded out of the page by other suites.

Response

Eval batches returned
batcheslist of objects
countdouble
hasMoreboolean

True when this page came back full — there may be more rows past it.

limitdouble
offsetdouble

Errors

401
Unauthorized Error
500
Internal Server Error