---
title: "Error issues (paginated)"
method: GET
path: "/errors/issues"
tags: ["Errors"]
---

# Error issues (paginated)

`GET /errors/issues`

## Request

- Base URL: `https://api.tatum.io/v4/logs`
- URL: `https://api.tatum.io/v4/logs/errors/issues`
- Auth: API key in header `x-api-key`

Aggregated error issues, paginated with a keyset cursor over
`(count, error_code, operation, network)`. Pass `next_cursor` from the
previous response back as `cursor` to fetch the next page.

## Query parameters

- `cursor` string
- `limit` integer
- `time_range` union
  - '5m'
  - '15m'
  - '1h'
  - '6h'
  - '24h'
  - '7d'
  - '14d'
  - '30d'
- `from` string, date-time
- `to` string, date-time
- `search` string
- `rank_by` union
  - 'errors'
  - 'usage'
- `filter[network][in]` string[]
- `filter[network][nin]` string[]
- `filter[chain][in]` string[]
- `filter[chain][nin]` string[]
- `filter[source][in]` string[]
- `filter[source][nin]` string[]
- `filter[operation][in]` string[]
- `filter[operation][nin]` string[]
- `filter[operation][contains]` string
- `filter[error_code][in]` integer[]
- `filter[error_code][nin]` integer[]
- `filter[error_code][between]` integer[]
- `filter[req_id][in]` string[]

## Response `200`

A keyset-paginated page of aggregated error issues.

- ErrorIssuePage: Keyset-paginated page of aggregated error issues.
  - `data` ErrorIssue[], required: Rows for the current page, in the query's sort order. **May hold more than the requested `limit`.** On the event endpoints `req_id` is not unique — one request emits one error row per failing JSON-RPC batch member — so a page that would end in the middle of a request is extended with that request's remaining rows. Ending mid-request is what would let the keyset cursor skip rows, so the overshoot is deliberate. Size a viewport on the rows actually returned, not on `limit`.
    - `fingerprint` string, required: Stable grouping key for the issue: `error_code:operation:network`.
    - `error_code` number, required: Representative error / status code for the group (JSON-RPC codes are negative).
    - `error_message` string, required: Representative (normalized) error message for the group.
    - `count` number, required: Number of occurrences in the window.
    - `share_pct` number, required: Share of in-scope errors this issue represents, as a percentage (2 dp).
    - `first_seen` string, required: First occurrence in the window, ISO-8601 UTC.
    - `last_seen` string, required: Most recent occurrence in the window, ISO-8601 UTC.
    - `trend` Sparkline, required: Compact time series used for trend visualizations (KPI cards, issue trends, per-source breakdowns). Points are ordered oldest → newest and cover the full requested window with empty buckets padded to `0`.
      - `points` SparklinePoint[], required: Ordered buckets, oldest first.
        - `timestamp` string, required: Start of the bucket, ISO-8601 UTC with a trailing `Z`.
        - `value` number, required: Aggregated count for the bucket (0 when the bucket is empty).
      - `total` number, required: Sum of `value` across all points — the window total in one number.
    - `severity` union, required: Severity classification derived from code and volume.
      - 'high'
      - 'medium'
      - 'low'
    - `source` string, required: Dominant error source for the group.
    - `chain` string, required: Dominant chain for the group.
    - `network` string, required: Dominant network for the group (chain-qualified).
    - `operation` string, required: Most frequently affected operation.
  - `next_cursor` string: Opaque cursor pointing at the row after the last one in `data`. Pass it back as `cursor` to retrieve the next page. Omitted when there are no more rows.
  - `capped` boolean: True when the request carried a `search`/`req_id` filter the issues rollup cannot honor exactly and the raw match count exceeded the cap. `data` is then empty — narrow the search or time range to see grouped issues.

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/tatum/apis/logs-api.md) - [All operations](https://skmtc.dev/tatum/apis/logs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/logs-api/revisions/e47603e0f75f?raw)