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.

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

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: 1Optional

Maximum number of items to return (default: 50)

Default: 50

tagsstring[]Optional

Filter by tags (can be specified multiple times)

branchesstring[]Optional

Filter by branches (can be specified multiple times)

groupsstring[]Optional

Filter by groups (can be specified multiple times)

authorsstring[]Optional

Filter by git authors (can be specified multiple times)

orderstring · enumOptional

Field to order results by

Default: titlePossible values:

dirstring · enumOptional

Sort direction

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

Responses

200

Successful response

application/json

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-01-08T01%3A50%3A04.852Z&date_end=2026-01-08T01%3A50%3A04.852Z 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,
          "failures": 1,
          "ignored": 1,
          "passes": 1,
          "flaky": 1,
          "flakinessRate": 1,
          "failureRate": 1,
          "avgDurationMs": 1,
          "flakinessVolume": 1,
          "failureVolume": 1,
          "durationVolume": 1
        },
        "latestTag": [
          "text"
        ],
        "lastSeen": "2026-01-08T01:50:04.852Z"
      }
    ],
    "count": 1,
    "total": 1,
    "nextPage": 1
  }
}