Skip to main content
GET
Explore test cases with aggregated metrics

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:25

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

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

Filter by behavioral status class. stable requires days=90.

Available options:
flaky,
chronic,
stable
specFilePath
string

Filter to test cases from a specific spec file path.

platform
string

Filter by test platform (e.g. chromium, firefox, webkit).

environment
string

Filter results by environment name (e.g. production, staging). Use the /filters endpoint to discover available environments.

tags
string

Single tag string (maps to downstream tag). Not comma-separated multi-tag.

days
enum<integer>
default:30

Rolling window in days. Must be 7, 30, or 90 (default 30). Other values return 400 downstream.

Available options:
7,
30,
90

Free-text search across test case names.

sortBy
enum<string>
default:suite_file_path

Sort field (maps to downstream sort). Default suite_file_path. Sort-dependent default direction applies when order is omitted.

Available options:
suite_file_path,
title,
flaky_rate,
failure_rate,
reliability_score,
total_runs,
p95_duration_ms,
duration_trend_slope,
consecutive_failure_streak,
last_seen_at,
last_duration_ms,
avg_duration_ms
order
enum<string>

Sort direction (maps to downstream dir). Default depends on sortBy — text sorts default asc, metrics default desc.

Available options:
asc,
desc

Response

Aggregated test case data

success
enum<boolean>
Available options:
true
data
object
pagination
object