v1

latestSwagger 2.02026-08-06114111152.5 KB

Insights

Test summary

Headline totals (success, failure, unknown) plus pass and failure rates for the selected period and filters. Ideal for a single-number dashboard tile.

get/v1/insights/summary

Query parameters

startstring

Period start. ISO-8601 (2026-06-01 or 2026-06-01T00:00:00Z) or a UNIX timestamp. Defaults to 30 days before end.

endstring

Period end. ISO-8601 or a UNIX timestamp. Defaults to now.

time_rangestring

Relative window as a shorthand for start: 24h, 7d, 4w (units h/d/w). Ignored when start is given.

status'all' | 'success' | 'failure' | 'unknown'

Filter by test status. One of all (default), success, failure, unknown.

browserinteger[]

Filter by test environment (browser/OS/device) IDs, comma-separated. Discover IDs via /v1/insights/filters.

buildinteger[]

Filter by build IDs, comma-separated.

group_idsinteger[]

Filter by group ("My Groups") IDs, comma-separated.

teaminteger[]

Filter by team member user IDs (who ran the test), comma-separated.

namestring

Filter to an exact test name.

Response

Test summary

startstring date-time required

Period start (ISO-8601, UTC).

endstring date-time required

Period end (ISO-8601, UTC).

statusstring required

Status filter applied.

totalinteger required

Total tests in the period.

successinteger required

Passed tests.

failureinteger required

Failed tests.

unknowninteger required

Unknown-status tests.

pass_ratenumber required

success / total, 0..1.

failure_ratenumber required

failure / total, 0..1.