List test runs
Test Runs
List test runs
Returns a paginated list of test runs for the scoped project, with optional filtering by id, branch, state, result, environment, and time window.
GET
List test runs
Test runs transition through these states:
A failed run may carry one of these error codes:
| State | Description |
|---|---|
pending | Run is queued behind other runs (concurrency limit reached) |
queued | Run is queued and will start soon |
started | Run is currently executing |
ended | Run completed successfully |
error | Run failed with an error |
cancelling | Run is being cancelled |
cancelled | Run was cancelled |
| Error code | Description |
|---|---|
merge_conflict | Merge conflict detected when merging the test branch |
dispatch_failed | Failed to dispatch the test run to workers |
report_not_generated | Test report was not generated |
run_failed_with_error | Test run failed with an error during execution |
worker_interrupted | Test run worker was interrupted |
merge_reports_failed | Failed to merge sharded reports |
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Return only the test run with this exact ID.
Required range:
x >= 1Items per page (max 100). Defaults to 20.
Required range:
1 <= x <= 100Page number (1-indexed). Defaults to 1.
Required range:
x >= 1Filter to runs on this test repo branch.
Restrict to runs created in the last N days.
Required range:
x >= 1Filter by run state (e.g. queued, ended).
Filter by overall run result.
Available options:
passed, failed Comma-separated environment IDs to filter by.