Explore test cases

Automated test cases with metrics aggregated across runs.

Returns pass rate, fail rate, flakiness, average duration, and last execution per test case. Filter by spec file, platform, environment, status, or tags to surface consistently failing, slow, or flaky tests.

GET /{projectId}/test-case-explorer

Explore test cases

cURL

curl --request GET \
  --url https://api.testdino.com/api/public/v1/{projectId}/test-case-explorer \
  --header 'Authorization: Bearer <token>'

200

{
  "success": true,
  "data": {
    "testCases": [
      {
        "fullTitle": "<string>",
        "title": "<string>",
        "specName": "<string>",
        "executions": 123,
        "platforms": [
          "<string>"
        ],
        "failureRate": 123,
        "flakyRate": 123,
        "avgDuration": 123,
        "tags": [
          "<string>"
        ],
        "lastRun": {
          "duration": 123,
          "timestamp": "2023-11-07T05:31:56Z",
          "testRunId": "<string>",
          "counter": 123,
          "branch": "<string>",
          "environment": "<string>"
        }
      }
    ],
    "pagination": {
      "page": 123,
      "limit": 123,
      "total": 123,
      "hasNext": true,
      "hasPrev": true
    },
    "appliedFilters": {
      "status": "<string>",
      "specFilePath": "<string>",
      "platform": "<string>",
      "environment": "<string>",
      "tags": "<string>",
      "days": 123,
      "dateRange": "<string>",
      "fromDate": "<string>",
      "toDate": "<string>",
      "search": "<string>",
      "sortBy": "<string>",
      "sortBy2": "<string>",
      "order": "<string>",
      "order2": "<string>",
      "testRunId": "<string>",
      "testRunIds": [
        "<string>"
      ]
    }
  }
}

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

Items per page (1–100, default 50).

Required range: x <= 100

status · string

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

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

Comma-separated tags to filter by.

days · integer · default: 30

Lookback period in days for metric aggregation (1–365, default 30).

Required range: 1 <= x <= 365

search · string

Free-text search across test case names.

sortBy · string · default: lastExecution

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

order · enum<string> · default: desc

Sort direction: asc or desc (default desc).

Available options: asc, desc

Response

200

application/json

Aggregated test case data

success · boolean

data · object

Show child attributes