curl --request GET \
--url https://api.testdino.com/api/public/v1/{projectId}/specs \
--header 'Authorization: Bearer <token>'{
"success": true,
"data": [
{
"filePath": "e2e/bulk-report.spec.js",
"fileName": "bulk-report.spec.js",
"status": "passed",
"successRate": 123,
"failureRate": 123,
"flakyRate": 123,
"executions": 123,
"duration": {
"latest": 123,
"avg": 123,
"min": 123,
"max": 123
},
"lastExecution": {
"testRunId": "<string>",
"testSuiteId": "<string>",
"counter": 123,
"branch": "<string>",
"environment": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}
],
"pagination": {
"page": 123,
"limit": 123,
"total": 123,
"hasNext": true,
"hasPrev": true
}
}Per-spec-file health metrics across recent runs.
Returns each spec (test file) with pass/fail counts, flakiness rate, average duration, and last execution. Useful for surfacing problematic spec files across your suite over a configurable lookback window (days, 1–365).
curl --request GET \
--url https://api.testdino.com/api/public/v1/{projectId}/specs \
--header 'Authorization: Bearer <token>'{
"success": true,
"data": [
{
"filePath": "e2e/bulk-report.spec.js",
"fileName": "bulk-report.spec.js",
"status": "passed",
"successRate": 123,
"failureRate": 123,
"flakyRate": 123,
"executions": 123,
"duration": {
"latest": 123,
"avg": 123,
"min": 123,
"max": 123
},
"lastExecution": {
"testRunId": "<string>",
"testSuiteId": "<string>",
"counter": 123,
"branch": "<string>",
"environment": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}
],
"pagination": {
"page": 123,
"limit": 123,
"total": 123,
"hasNext": true,
"hasPrev": true
}
}Project PAT (tdp_) token with public-api scope
The project identifier (e.g. project_abc123). Must match the project associated with your PAT.
Page number for paginated results. Starts at 1.
x >= 1Number of items per page (1–100, default 20).
1 <= x <= 100Filter specs by their aggregated status (e.g. passed, failed, flaky).
Filter results by environment name (e.g. production, staging). Use the /filters endpoint to discover available environments.
Search by spec file path or name.
Lookback period in days for aggregating spec metrics (1–365, default 30).
1 <= x <= 365Field to sort by (e.g. lastExecution, failRate, avgDuration).
Sort direction: asc (ascending) or desc (descending).
asc, desc Was this page helpful?