List eval suites | Runtype Documentation

{
  "count": 1,
  "limit": 1,
  "offset": 1,
  "suites": [
    {
      "agentId": "agent_9f8b7c6d",
      "baselineBatchExecutionId": "batch_20240601_001",
      "caseCount": 25,
      "createdAt": "2024-05-20T10:15:30Z",
      "description": "Regression tests for user login flow",
      "enabledCaseCount": 20,
      "flowId": "flow_123abc",
      "graders": [
        null
      ],
      "id": "suite_456def",
      "isDefault": true,
      "lastModifiedSource": "sdk",
      "latestRun": {
        "completedAt": "2024-06-01T12:00:00Z",
        "passedCases": 18,
        "runId": "run_789ghi",
        "score": 0.9,
        "startedAt": "2024-06-01T11:30:00Z",
        "status": "completed",
        "totalCases": 20
      },
      "name": "User Login Flow Suite",
      "recordedToolMode": "next_step",
      "recordedToolUnmatchedPolicy": "fail",
      "targetName": "User Login Flow",
      "targetType": "flow",
      "updatedAt": "2024-06-01T12:05:00Z"
    }
  ],
  "total": 1
}

List eval suites in the account scope with case counts and each suite’s latest run + score. Filter by target with flowId/agentId.

Authentication

AuthorizationBearer

API key or Clerk session token

Query parameters

flowIdstringOptional

Filter to suites targeting this flow

agentIdstringOptional

Filter to suites targeting this agent

limitstringOptional

Number of results (default 50, max 100)

offsetstringOptional

Pagination offset

Response

Eval suites returned

countinteger

Number of suites in this page.

limitinteger

offsetinteger

suiteslist of objects

totalinteger

Total suites matching the filter across all pages (for offset pagination).

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

$	curl https://api.runtype.com/v1/eval/suites \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json"