Errors Explorer

Query and filter errors from the Error Explorer.

Returns aggregated error metrics for a project within a date range, with optional filters for error target, message, category, action, tags, branches, authors, and groups.

Get errors explorer

get

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

/errors/{projectId}

Get aggregated error metrics for a project within a date range. Supports filtering by error_target, error_message, error_category, error_action, tags, branches, authors, and groups.

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

Maximum number of results (1-100)

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"]

tags_logical_operatorstring · enumOptional

Logical operator for tags filter: OR (match any) or AND (match all). Default: OR.

Default: ORPossible values:

branches[]string[]Optional

Filter by branches (can be specified multiple times using bracket notation, e.g., branches[]=main&branches[]=develop)

Example: ["main","develop"]

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"]

error_targetstringOptional

Filter by error target (e.g. CSS selector, URL)

error_messagestringOptional

Filter by error message (case-insensitive partial match)

error_categorystringOptional

Filter by error category

error_actionstringOptional

Filter by error action

order_bystring · enumOptional

Field to order results by

Default: countPossible values:

dirstring · enumOptional

Sort direction

Default: descPossible values:

metricstring · enumOptional

Metric used for timeline ranking (occurrence, test, or branch)

Default: occurrencePossible values:

top_ninteger · min: 1 · max: 50Optional

Maximum number of top errors per timeline bucket (1-50). Default: 5.

Default: 5

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

/errors/{projectId}

HTTPcURLJavaScriptPython

GET /v1/errors/{projectId}?date_start=2026-02-19T20%3A46%3A38.007Z&date_end=2026-02-19T20%3A46%3A38.007Z HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "OK",
  "data": {
    "list": [
      {
        "message": "text",
        "error_category": "text",
        "error_action": "text",
        "error_target": "text",
        "count": 1,
        "details": {
          "tests": {
            "count": 1
          },
          "branches": {
            "count": 1
          }
        }
      }
    ],
    "timeline": [
      {
        "date": "text",
        "count": 1,
        "items": [
          {
            "message": "text",
            "error_category": "text",
            "error_action": "text",
            "error_target": "text",
            "count": 1,
            "details": {
              "tests": {
                "count": 1
              },
              "branches": {
                "count": 1
              }
            }
          }
        ]
      }
    ],
    "count": 1,
    "total": 1,
    "nextPage": 1
  }
}