Skip to main content
GET
/
api
/
v2
/
analytics
/
test-runs
Test Runs Analytics (v2)
curl --request GET \
  --url https://dash.empirical.run/api/v2/analytics/test-runs \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "daily": [
      {
        "date": "2025-02-01",
        "run_count": 5,
        "passed_runs": 4,
        "failed_runs": 1,
        "error_runs": 0,
        "cancelled_runs": 0,
        "rerun_count": 1,
        "total_tests": 750,
        "passed_tests": 720,
        "failed_tests": 20,
        "failed_tests_after_snooze": 15,
        "flaky_tests": 10
      }
    ],
    "summary": {
      "total_runs": 45,
      "passed_runs": 40,
      "failed_runs": 5,
      "error_runs": 0,
      "pass_rate": 89,
      "avg_tests_per_run": 150,
      "rerun_count": 3,
      "rerun_rate": 7
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.empirical.run/llms.txt

Use this file to discover all available pages before exploring further.

Returns test run statistics aggregated by day, including run counts, pass/fail breakdown, and test-level metrics. Response shape is identical to v1. 
{
  "data": {
    "daily": [
      {
        "date": "2025-02-01",
        "run_count": 5,
        "passed_runs": 4,
        "failed_runs": 1,
        "error_runs": 0,
        "cancelled_runs": 0,
        "rerun_count": 1,
        "total_tests": 750,
        "passed_tests": 720,
        "failed_tests": 20,
        "failed_tests_after_snooze": 15,
        "flaky_tests": 10
      }
    ],
    "summary": {
      "total_runs": 45,
      "passed_runs": 40,
      "failed_runs": 5,
      "error_runs": 0,
      "pass_rate": 89,
      "avg_tests_per_run": 150,
      "rerun_count": 3,
      "rerun_rate": 7
    }
  }
}

​
Get last 30 days of test runs

curl -X GET \
  "https://dash.empirical.run/api/v2/analytics/test-runs?days=30" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY"

​
Filter by branch

curl -X GET \
  "https://dash.empirical.run/api/v2/analytics/test-runs?days=30&branch=main" \
  -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 30). 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.

​
branch
string

Filter by branch name.

Response

Test run analytics data.

​
data
object
required