List Evaluation Runs

Database selection

Use an evaluation-capable database registered with AgentOS or its components. The example API server registers SQLite through its agent. When several database IDs are available, supply db_id; selecting table also requires db_id. These values select registered storage, not an arbitrary database connection. Authentication and configured user scoping apply to the stored evaluation records.

The response contains both data and meta. The generated example below abbreviates this envelope. For an empty first page, the shape is:

{"data":[],"meta":{"page":1,"limit":20,"total_count":0,"total_pages":0}}

eval_types accepts comma-separated evaluation types. Unsupported values return 422.

GET/eval-runs

Retrieve paginated evaluation runs with filtering and sorting options. Filter by agent, team, workflow, model, or evaluation type.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Query Parameters

agent_id?|

Agent ID

team_id?|

Team ID

workflow_id?|

Workflow ID

model_id?|

Model ID

type?|

Filter type

limit?|

Number of eval runs to return

Default20
page?|

Page number

Default1
sort_by?|

Field to sort by

Default"created_at"
sort_order?|

Sort order (asc or desc)

Default"desc"
db_id?|

The ID of the database to use

table?|

The database table to use

eval_types?|

Comma-separated eval types (accuracy,agent_as_judge,performance,reliability)

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl --request GET 'https://example.com/eval-runs'
{  "data": [    {      "id": "a03fa2f4-900d-482d-afe0-470d4cd8d1f4",      "agent_id": "basic-agent",      "model_id": "gpt-4o",      "model_provider": "OpenAI",      "name": "Test ",      "eval_type": "reliability",      "eval_data": {        "eval_status": "PASSED",        "failed_tool_calls": [],        "passed_tool_calls": [          "multiply"        ]      },      "eval_input": {        "expected_tool_calls": [          "multiply"        ]      },      "created_at": "2025-08-27T15:41:59Z",      "updated_at": "2025-08-27T15:41:59Z"    }  ]}