Error events (paginated)

get

https://api.tatum.io/v4/logs/errors/events

Individual error events, paginated with a keyset cursor over
(timestamp, req_id). Pass next_cursor from the previous response back as
cursor to fetch the next page.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

cursor

string

length ≤ 512

Opaque keyset cursor from the previous page's next_cursor. Omit for the
first page.

limit

integer

1 to 1000

Maximum rows to return (1–1000). Defaults to the endpoint's page size when
omitted.

time_range

Relative look-back window. Ignored when from/to are supplied.

from

date-time

Inclusive window start, ISO-8601. Use together with to for an explicit
range instead of time_range.

date-time

Exclusive window end, ISO-8601. Defaults to now when only from is given.

string

length between 3 and 128

^[^\x00-\x1f\x7f]*$

Free-text search across error fields (message, operation, ids). Control
bytes are rejected; min 3 chars (text-index floor), max 128 chars.

rank_by

Ranking dimension for aggregated views: errors orders by error volume,
usage orders by total request volume.

filter[network][in]

array of strings

Include rows where network (blockchain network (chain-qualified)) is one of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no network (unattributed traffic).

filter[network][in]

filter[network][nin]

array of strings

Exclude rows where network (blockchain network (chain-qualified)) is none of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no network (unattributed traffic).

filter[network][nin]

filter[chain][in]

array of strings

Include rows where chain (parent blockchain as recorded on the error; unrecognised values match no rows rather than erroring) is one of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no chain (unattributed traffic).

filter[chain][in]

filter[chain][nin]

array of strings

Exclude rows where chain (parent blockchain as recorded on the error; unrecognised values match no rows rather than erroring) is none of the given values. Repeat the parameter to pass multiple values. Pass (empty) to match rows with no chain (unattributed traffic).

filter[chain][nin]

filter[source][in]

array of strings

Include rows where source (error source / originating layer) is one of the given values. Repeat the parameter to pass multiple values.

filter[source][in]

filter[source][nin]

array of strings

Exclude rows where source (error source / originating layer) is none of the given values. Repeat the parameter to pass multiple values.

filter[source][nin]

filter[operation][in]

array of strings

Include rows where operation (RPC method / operation) is one of the given values. Repeat the parameter to pass multiple values.

filter[operation][in]

filter[operation][nin]

array of strings

Exclude rows where operation (RPC method / operation) is none of the given values. Repeat the parameter to pass multiple values.

filter[operation][nin]

filter[operation][contains]

string

length ≤ 128

Include rows where operation (RPC method / operation) contains this substring (SQL LIKE '%value%').

filter[error_code][in]

array of int32s

Include rows where error_code (error / status code (JSON-RPC codes are negative)) is one of the given values. Repeat the parameter to pass multiple values.

filter[error_code][in]

filter[error_code][nin]

array of int32s

Exclude rows where error_code (error / status code (JSON-RPC codes are negative)) is none of the given values. Repeat the parameter to pass multiple values.

filter[error_code][nin]

filter[error_code][between]

array of int32s

length between 2 and 2

Include rows where error_code (error / status code (JSON-RPC codes are negative)) falls within an inclusive numeric range (SQL BETWEEN lo AND hi). Pass the parameter exactly twice: first the lower bound, then the upper bound.

filter[error_code][between]

filter[req_id][in]

array of strings

Include rows where req_id (request id (exact lookup)) is one of the given values. Repeat the parameter to pass multiple values.

filter[req_id][in]

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200A keyset-paginated page of individual error events.

401Unauthorized