Skip to main content
GET
List test runs with filtering and pagination

Authorizations

Authorization
string
header
required

User PAT (td_pat_) scoped to the target project

Path Parameters

projectId
string
required

The project identifier (e.g. project_abc123). Must match the project associated with your PAT.

Query Parameters

page
integer
default:1

Page number for paginated results. Starts at 1.

Required range: x >= 1
limit
enum<integer>
default:10

Page size. Must be one of 10, 25, 50, or 100 (default 10). Any other value returns 400 INVALID_LIMIT.

Available options:
10,
25,
50,
100
status
enum<string>

Filter by run status. CSV allowed (e.g. failed,interrupted).

Available options:
passed,
failed,
interrupted,
incomplete,
running
branch
string

Filter by git branch (CSV allowed).

environment
string

Filter by environment name (must exist for this project).

author
string

Filter by git commit author (CSV allowed).

run_tags
string

Comma-separated run-level tags (e.g. smoke,prod).

test_case_tags
string

Comma-separated test-case tags that must appear on cases in the run.

tag_match
enum<string>

When set to exact, tag filters require an exact tag match.

Available options:
exact

Free-text search across commit messages and run counter numbers.

start_date
string<date-time>

Start of run time window (RFC3339). Must be used with end_date.

end_date
string<date-time>

End of run time window (RFC3339). Must be used with start_date.

sort
enum<string>
default:counter_desc

Sort order for the run list.

Available options:
counter_desc,
counter_asc,
duration_asc,
duration_desc

Response

Paginated list of test runs

success
boolean
data
object[]
pagination
object