List test runs with filtering and pagination
Returns a paginated list of test runs for the project. Default sort is counter_desc
(newest counter first). Query parameter names match the data-handler /runs endpoint
(snake_case).
Date range: pass start_date and end_date together as RFC3339 timestamps
(e.g. 2026-03-01T00:00:00Z). There is no period or camelCase date alias.
Authorizations
User PAT (td_pat_) scoped to the target project
Path Parameters
The project identifier (e.g. project_abc123). Must match the project associated with your PAT.
Query Parameters
Page number for paginated results. Starts at 1.
x >= 1Page size. Must be one of 10, 25, 50, or 100 (default 10). Any other value returns 400 INVALID_LIMIT.
10, 25, 50, 100 Filter by run status. CSV allowed (e.g. failed,interrupted).
passed, failed, interrupted, incomplete, running Filter by git branch (CSV allowed).
Filter by environment name (must exist for this project).
Filter by git commit author (CSV allowed).
Comma-separated run-level tags (e.g. smoke,prod).
Comma-separated test-case tags that must appear on cases in the run.
When set to exact, tag filters require an exact tag match.
exact Free-text search across commit messages and run counter numbers.
Start of run time window (RFC3339). Must be used with end_date.
End of run time window (RFC3339). Must be used with start_date.
Sort order for the run list.
counter_desc, counter_asc, duration_asc, duration_desc