TAtatum
Errors

Get error event

Returns a single error event by its event_id, enriched with the access fields of its HTTP request and the other errors that request produced.

event_id comes from the /errors/events list. A raw req_id is not a valid key — one request can produce many errors — and yields 400. To see every error of one request, use /errors/events?filter[req_id][in]=….

get/errors/events/{id}

Request

  • Base URL
    https://api.tatum.io/v4/logs
  • URL
    https://api.tatum.io/v4/logs/errors/events/{id}
  • Auth
    API key in header x-api-key

Path parameters

idstring required

Response

The error event, its request's access fields, and its siblings.

siblings_truncatedboolean required

True when the request produced more errors than siblings can carry, so the array is a prefix rather than the whole batch.

event_idstring required

Opaque identifier for this individual error row, and the only stable address for it. req_id is NOT unique — one request emits one error row per failing JSON-RPC batch member — so use this for GET /errors/events/{id} and filter[event_id][in], never req_id.

req_idstring required

Request identifier, and the join key across access and error logs. Not unique: a JSON-RPC batch request emits one error row per failing member, all sharing this value. Use event_id to address a single error.

timestampstring required

When the error occurred, ISO-8601 UTC.

operationstring required

RPC method / operation that failed.

error_codenumber required

Error / status code (JSON-RPC codes are negative).

error_messagestring required

Human-readable error message.

error_datastring required

Raw error payload / provider detail (may be JSON-encoded).

request_contextstring required

Serialized request context captured with the error (redacted).

sourcestring required

Error source / originating layer.

trace_idstring required

Distributed-trace identifier for correlating across services.

json_rpc_idstring required

JSON-RPC id of the failing call, when applicable.

gateway_idstring required

Gateway that served the request.

interface_idstring required

Interface (chain-network endpoint) that handled the request.

chainstring required

Blockchain the request targeted.

networkstring required

Chain-qualified network the request targeted.

regionstring required

Serving region.

typestring required

Error classification / bucket.

Example response

{
  "access": {
    "ua": "tatum-sdk/4.2.0",
    "req_time_ms": 63,
    "remote_ip": "203.0.113.42"
  },
  "siblings": [
    {
      "event_id": "djE6MTc4Nzc0MzIxNjA1ODoyMkUzMzg3QUEwRjlEM0M2OnFncHptLTBmNWE1OTJm",
      "json_rpc_id": "1",
      "error_code": 3,
      "operation": "eth_call",
      "error_message": "execution reverted"
    }
  ],
  "event_id": "djE6MTc4Nzc0MzIxNjA1ODoyMkUzMzg3QUEwRjlEM0M2OnFncHptLTBmNWE1OTJm",
  "req_id": "a309e3a8edccb942-AMS",
  "timestamp": "2024-01-14T12:00:00.000Z",
  "operation": "eth_call",
  "error_code": 3,
  "error_message": "execution reverted",
  "error_data": "{\"code\":3,\"message\":\"execution reverted\",\"data\":\"0x08c379a0\"}",
  "request_context": "{\"params\":[\"0xabc...\",\"latest\"]}",
  "source": "blockchain-rpc",
  "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736",
  "json_rpc_id": "1",
  "gateway_id": "1e06265e-f014-48ae-9cc6-94d046e4e04d",
  "interface_id": "ethereum-mainnet-json-rpc",
  "chain": "ethereum",
  "network": "ethereum-mainnet",
  "region": "europe-west4",
  "type": "jsonrpc_error_event"
}

Changes

No recorded changes to this operation across all 1 revision of this API.