Skip to main content
GET
/
api
/
test-cases
/
v2
List Test Cases
curl --request GET \
  --url https://dash.empirical.run/api/test-cases/v2 \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "test_cases": [
      {
        "id": "<string>",
        "name": "<string>",
        "file_path": "<string>",
        "suites": [
          "<string>"
        ],
        "playwright_project": "<string>",
        "tags": [
          "<string>"
        ],
        "created_at": "<string>",
        "updated_at": "<string>",
        "first_seen_commit_sha": "<string>",
        "last_seen_commit_sha": "<string>"
      }
    ]
  },
  "pagination": {
    "page": 123,
    "per_page": 123,
    "total": 123,
    "total_pages": 123
  }
}

Authorizations

Authorization
string
header
required

API key from the Empirical dashboard.

Query Parameters

project_id
number
required

The project ID.

Text search across test name, file path, and suites.

file_path
string

Filter by file path (prefix match).

playwright_project
string

Filter by Playwright project name (e.g. "chromium").

tags
string

Comma-separated list of tags to filter by.

first_seen_commit_sha
string

Filter by the commit SHA where the test was first seen.

last_seen_commit_sha
string

Filter by the commit SHA where the test was last seen.

is_active
string

When true (default), returns only active tests. Set to false to include all tests.

per_page
number

Items per page (default 100).

page
number

Page number (1-indexed, default 1).

Response

Paginated list of test cases.

data
object
required
pagination
object
required