List Test Runs
list_testrunsBrowse a project's test runs with filters for status, branch, author, commit, environment, and time to retrieve run metadata and testrun_id values for follow-up queries.
Instructions
Browse test runs for a project with optional filters. Use this when you need run-level metadata: pass/fail totals, duration, branch, commit, author, or when you need testrun_id values for follow-up calls. Use specific filters and pagination instead of fetching broad result sets. You do NOT need to call this before list_testcase when you already have branch/time/author filters — list_testcase resolves runs internally. Common time values: "1d", "3d", "weekly", "monthly", or "YYYY-MM-DD,YYYY-MM-DD" for a custom range.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>"
},
"name": "list_testruns"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-indexed page number (default: 1) | |
| sort | No | Run list sort order | |
| limit | No | Items per page: 10, 25, 50 or 100. Any other value is rounded to the nearest, and the answer's `warnings` says so. | |
| search | No | Search run commit message, or exact counter when numeric | |
| by_author | No | Filter by commit author | |
| by_branch | No | Filter by git branch name | |
| by_commit | No | Filter by commit hash prefix | |
| by_status | No | Filter by run status | |
| projectId | Yes | Project ID (e.g. project_<id>) | |
| by_environment | No | Filter by CI/deployment environment | |
| by_test_controls | No | Runs Test Controls changed, as the runs list filter: "excluded" = had quarantined failures, "critical" = a critical test passed only on retry, "any" = changed by Test Controls. Each run carries `quarantine` ({state, excluded_count, critical_flaky}; null for reporters before 2.8.0). | |
| by_time_interval | No | Time filter: "1h", "1d", "weekly", "monthly", "last 5 days", or "YYYY-MM-DD,YYYY-MM-DD" | |
| by_test_case_tags | No | Comma-separated test case tags contained in the run |