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

/errors/{projectId}

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

Authorizations

AuthorizationstringRequired

An organization API key, sent as Authorization: Bearer <key>. A key carries one scope for the whole API: a read key reaches the GET endpoints, a write key reaches all of them. A crnts_pat_ personal access token is accepted as a Bearer while its owner remains an eligible administrator in its active organization. Each operation requires the corresponding scope stored on that 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:

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

test_titlestringOptional

Filter by test title (case-insensitive partial match)

order_bystring · enumOptional

Field to order results by

Default: countPossible values:

dirstring · enumOptional

Sort direction: desc (default) or asc.

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

403

The credential authenticated but is not permitted to use this endpoint. Five refusals share the status: a read API key on an endpoint that writes, an OAuth token that was not granted the scope the endpoint needs (insufficient_scope), an OAuth token that was granted it but whose holder no longer has a role permitting it (insufficient_role), an OAuth token on an endpoint that accepts an API key and nothing else (api_key_required), and an API key on an endpoint that answers for a user (user_credential_required). Discriminate on code rather than on the message, which is free-form. The first refusal predates the codes and sets none. Only insufficient_scope carries the challenge header, because it is the only one a client can act on by re-authorizing.

application/json

404

Resource not found

application/json

get/errors/{projectId}

GET /v1/errors/{projectId}?date_start=2026-01-01T00%3A00%3A00.000Z&date_end=2026-01-01T00%3A00%3A00.000Z 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",
        "signature": "text",
        "title": "text",
        "spec": "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",
            "signature": "text",
            "title": "text",
            "spec": "text",
            "count": 1,
            "details": {
              "tests": {
                "count": 1
              },
              "branches": {
                "count": 1
              }
            }
          }
        ]
      }
    ],
    "count": 1,
    "total": 1,
    "nextPage": 1
  }
}