Skip to main content
GET
/
{projectId}
/
specs
List specs
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
  }
}

Authorizations

Authorization
string
header
required

Project PAT (tdp_) token with public-api scope

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
integer
default:20

Number of items per page (1–100, default 20).

Required range: 1 <= x <= 100
status
string

Filter specs by their aggregated status (e.g. passed, failed, flaky).

environment
string

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

Search by spec file path or name.

days
integer
default:30

Lookback period in days for aggregating spec metrics (1–365, default 30).

Required range: 1 <= x <= 365
sortBy
string

Field to sort by (e.g. lastExecution, failRate, avgDuration).

order
enum<string>

Sort direction: asc (ascending) or desc (descending).

Available options:
asc,
desc

Response

Paginated spec health list

success
boolean
data
object[]
pagination
object