Skip to main content
GET
/
api
/
v2
/
analytics
/
test-cases
Test Cases Analytics (v2)
curl --request GET \
  --url https://dash.empirical.run/api/v2/analytics/test-cases \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "test_cases": [
      {
        "test_case_id": "abc-123-def",
        "test_name": "should login successfully",
        "file_path": "tests/auth/login.spec.ts",
        "project_name": "my-project",
        "tags": ["smoke", "auth"],
        "last_run_at": "2025-02-01T10:30:00.000Z",
        "metrics": {
          "total_runs": 20,
          "pass_count": 18,
          "fail_count": 1,
          "flaky_count": 1,
          "pass_rate": 90,
          "fail_rate": 5,
          "flaky_rate": 5
        }
      }
    ],
    "summary": {
      "total_test_cases": 150,
      "test_cases_with_history": 145
    }
  }
}
Returns test case analytics with aggregated metrics. Supports filtering, searching, and sorting.
Unlike v1, this endpoint does not include per-execution history. Fetch history separately with POST /api/v2/analytics/test-case-history/batch for the rows you actually need. Splitting the two queries keeps the table query fast.
{
  "data": {
    "test_cases": [
      {
        "test_case_id": "abc-123-def",
        "test_name": "should login successfully",
        "file_path": "tests/auth/login.spec.ts",
        "project_name": "my-project",
        "tags": ["smoke", "auth"],
        "last_run_at": "2025-02-01T10:30:00.000Z",
        "metrics": {
          "total_runs": 20,
          "pass_count": 18,
          "fail_count": 1,
          "flaky_count": 1,
          "pass_rate": 90,
          "fail_rate": 5,
          "flaky_rate": 5
        }
      }
    ],
    "summary": {
      "total_test_cases": 150,
      "test_cases_with_history": 145
    }
  }
}

​
List test cases sorted by fail rate

curl -X GET \
  "https://dash.empirical.run/api/v2/analytics/test-cases?days=7&order_by=fail_rate&limit=50" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY"

​
Get metrics for a single test case

curl -X GET \
  "https://dash.empirical.run/api/v2/analytics/test-cases?test_case_id=abc-123-def&days=30" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY"

curl -X GET \
  "https://dash.empirical.run/api/v2/analytics/test-cases?search=login&tags=smoke,auth" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY"

Authorizations

​
Authorization
string
header
required

Project API key from the Empirical dashboard.

Query Parameters

​
days
number

Number of days of history (1-90, default 7). Ignored if start_date and end_date are provided.

​
start_date
string

Start of custom date range (ISO 8601). Must be used together with end_date.

​
end_date
string

End of custom date range (ISO 8601). Must be used together with start_date.

​
environment_id
string

Filter by environment ID.

​
test_case_id
string

Fetch metrics for a single test case. When provided, search, tags, order_by, order, and limit are ignored.

​
search
string

Substring match on test name or file path.

​
tags
string

Comma-separated tags to filter by (includes match).

​
order_by
string

Sort field. Allowed values: fail_rate, flaky_rate, last_run.

​
order
string

Sort direction. Allowed values: asc, desc.

​
limit
number

Maximum number of test cases to return (1-500, default 100).

​
is_active
string

Set to false to include test cases that no longer exist in the latest synced revision. Defaults to true (active only).

Response

Test case analytics (metrics only).

​
data
object
required