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

# 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.

## 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[]
- `tags_logical_operator` 'OR' | 'AND'
- `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[]
- `error_target` string
- `error_message` string
- `error_category` string
- `error_action` string
- `test_title` string
- `order_by` 'count' | 'tests' | 'branches' | 'error'
- `dir` 'asc' | 'desc'
- `group_by[]` string[]
- `metric` 'occurrence' | 'test' | 'branch'
- `top_n` integer

## Response `200`

Successful response

- ErrorsExplorerResponse
  - `status` 'OK', required
  - `data` object, required
    - `list` ErrorsExplorerItem[] — Error items for the current page
      - `message` string, nullable
      - `error_category` string, nullable
      - `error_action` string, nullable
      - `error_target` string, nullable
      - `signature` string, nullable — Test signature. Present only when group_by includes `test`.
      - `title` string, nullable — Test title. Present only when group_by includes `test`.
      - `spec` string, nullable — Spec file path. Present only when group_by includes `test`.
      - `count` integer
      - `details` object
        - `tests` object
          - `count` integer
        - `branches` object
          - `count` integer
    - `timeline` ErrorsExplorerTimelineItem[] — Time-bucketed top errors (date, count, items per bucket)
      - `date` string
      - `count` integer
      - `items` ErrorsExplorerItem[]
        - `message` string, nullable
        - `error_category` string, nullable
        - `error_action` string, nullable
        - `error_target` string, nullable
        - `signature` string, nullable — Test signature. Present only when group_by includes `test`.
        - `title` string, nullable — Test title. Present only when group_by includes `test`.
        - `spec` string, nullable — Spec file path. Present only when group_by includes `test`.
        - `count` integer
        - `details` object
          - `tests` object
            - `count` integer
          - `branches` object
            - `count` integer
    - `count` integer — Number of items in the current page
    - `total` integer — Total number of errors matching the filter
    - `nextPage` union — Next page number (0-indexed) or false if no more pages
      - 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)