---
title: "Get tests explorer"
method: GET
path: "/tests/{projectId}"
tags: ["Tests Explorer"]
---

# Get tests explorer

`GET /tests/{projectId}`

Get aggregated test metrics for a project within a date range. Outcomes use the `RecordedTestOutcome` schema (see components/schemas). For narrative context, see the [Test result statuses](https://docs.currents.dev/dashboard/test-suite-performance-explorer/tests-explorer#test-result-statuses) section on the Test Explorer documentation page.

## Path parameters

- `projectId` string, required

## Query parameters

- `date_start` string, date-time, required
- `date_end` string, date-time, required
- `page` integer
- `limit` integer
- `tags[]` string[]
- `branches[]` BranchFilterQueryValue[]
  - union — Branch filter value: an exact branch name, or a trailing `*` for prefix match (e.g. `release/*`). Max 250 characters.
    - string — Exact branch name (must not contain `*` or spaces).
    - string — Prefix match: branch prefix followed by `*`.
- `groups[]` string[]
- `authors[]` string[]
- `environments[]` string[]
- `order` 'failures' | 'passes' | 'flakiness' | 'flakinessXSamples' | 'failRateXSamples' | 'duration' | 'durationDelta' | 'flakinessRateDelta' | 'failureRateDelta' | 'durationXSamples' | 'executions' | 'title'
- `dir` 'asc' | 'desc'
- `spec` string
- `title` string
- `min_executions` integer
- `test_state[]` RecordedTestOutcome[]
- `annotations` string

## Response `200`

Successful response

- TestsExplorerResponse
  - `status` 'OK', required
  - `data` object, required
    - `list` TestExplorerItem[]
      - `title` string — Test title
      - `signature` string — Unique test signature
      - `spec` string — Spec file path
      - `metrics` object — Aggregates for the query window. Outcomes follow `RecordedTestOutcome` (see components/schemas): `pending` → `ignored`; `failed` and `skipped` → `failures`.
        - `executions` integer — Number of executions in the window matching the executions status filter.
        - `passes` integer — Executions with outcome `passed`.
        - `failures` integer — Executions with outcome `failed` or `skipped` (no separate skipped counter).
        - `ignored` integer — Executions with outcome `pending` (intentional skip; “Ignored” in the dashboard).
        - `flaky` integer — Executions flagged flaky within the flakiness-rate status filter.
        - `flakinessRate` number — Flaky executions ÷ flakiness denominator (0–1).
        - `failureRate` number — Failed+skipped executions ÷ failure-rate denominator (0–1).
        - `avgDurationMs` number — Mean duration in ms over the avg-duration status filter.
        - `flakinessVolume` number — Flakiness impact: rate × flakiness-denominator executions (rounded).
        - `failureVolume` number — Failure impact: rate × failure-rate denominator executions (rounded).
        - `durationVolume` number — Duration impact: avg duration × executions used for duration (rounded).
      - `latestTag` string[], nullable
      - `latestAnnotations` object[] — Annotations from the most recent execution of this test.
        - `type` string, required — Annotation type
        - `description` string, nullable — Annotation description
      - `lastSeen` string, date-time, nullable
    - `count` integer
    - `total` integer
    - `nextPage` union
      - integer
      - boolean

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication failed
- `404` — Resource not found

---

[API](https://skmtc.dev/currents/apis/currents-rest-api.md) · [All operations](https://skmtc.dev/currents/apis/currents-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/currents/currents-rest-api/revisions/d0e2ed0e7e6a/schema)