Tests Explorer

Explore and analyze test metrics.

The Tests Explorer provides aggregated metrics for tests within a project, including execution counts, failure rates, flakiness rates, and duration statistics.

Outcome strings are defined in the RecordedTestOutcome schema (see components/schemas). That schema explains how each value maps to metrics on GET /tests/{projectId} (ignored, failures, etc.).

Narrative context for the dashboard is here: Test result statuses — Tests Explorer & REST API.

Get tests explorer

get

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/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 section on the Test Explorer documentation page.

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Path parameters

projectIdstringRequired

The project ID

Example: proj_abc123

Query parameters

date_startstring · date-timeRequired

Start date in ISO 8601 format

Example: 2024-01-01T00:00:00.000Z

date_endstring · date-timeRequired

End date in ISO 8601 format

Example: 2024-01-31T23:59:59.999Z

pageintegerOptional

Page number (0-indexed)

Default: 0

limitinteger · min: 1 · max: 50Optional

Maximum number of items to return (default: 50, max: 50)

Default: 50

tags[]string[]Optional

Filter by tags (can be specified multiple times using bracket notation, e.g., tags[]=value1&tags[]=value2)

Example: ["tag1","tag2"]

groups[]string[]Optional

Filter by groups (can be specified multiple times using bracket notation, e.g., groups[]=group1&groups[]=group2)

Example: ["group1","group2"]

authors[]string[]Optional

Filter by git authors (can be specified multiple times using bracket notation, e.g., authors[]=author1&authors[]=author2)

Example: ["author1","author2"]

orderstring · enumOptional

Field to order results by

Default: titlePossible values:

dirstring · enumOptional

Sort direction: desc (default) or asc.

Default: descPossible values:

specstringOptional

Filter tests by spec file name (partial match)

titlestringOptional

Filter tests by title (partial match)

min_executionsinteger · min: 1Optional

Minimum number of executions to include

metric_settingsanyOptional

Overrides which outcomes feed each metric. Keys: executions, avgDuration, flakinessRate, failureRate — each value is an array of RecordedTestOutcome. Omitted keys use defaults. Pass as a JSON value (same encoding as content: application/json for this parameter).

annotationsstringOptional

Filter by test annotations. The parameter value must be a JSON-stringified array of objects: [{ "type": "string", "description": "string" | ["string"] or null }]. description is optional; omit or set to null to match any value for that annotation.

Example: [{"type":"owner","description":["John Doe"]},{"type":"skip"}]

Responses

200

Successful response

application/json

statusstring · enumRequiredPossible values:

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

get

/tests/{projectId}

HTTPcURLJavaScriptPython

GET /v1/tests/{projectId}?date_start=2026-05-18T15%3A12%3A27.405Z&date_end=2026-05-18T15%3A12%3A27.405Z HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "OK",
  "data": {
    "list": [
      {
        "title": "text",
        "signature": "text",
        "spec": "text",
        "metrics": {
          "executions": 1,
          "passes": 1,
          "failures": 1,
          "ignored": 1,
          "flaky": 1,
          "flakinessRate": 1,
          "failureRate": 1,
          "avgDurationMs": 1,
          "flakinessVolume": 1,
          "failureVolume": 1,
          "durationVolume": 1
        },
        "latestTag": [
          "text"
        ],
        "lastSeen": "2026-05-18T15:12:27.405Z"
      }
    ],
    "count": 1,
    "total": 1,
    "nextPage": 1
  }
}