Skip to main content
GET
/
{projectId}
/
test-case-explorer
Explore test cases
curl --request GET \
  --url https://api.testdino.com/api/public/v1/{projectId}/test-case-explorer \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "testCases": [
      {
        "fullTitle": "<string>",
        "title": "<string>",
        "specName": "<string>",
        "executions": 123,
        "platforms": [
          "<string>"
        ],
        "failureRate": 123,
        "flakyRate": 123,
        "avgDuration": 123,
        "tags": [
          "<string>"
        ],
        "recentStatus": "passed",
        "lastRun": {
          "status": "passed",
          "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

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

Aggregated test case data

success
boolean
data
object