Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

block_results - Stable

Example code for the block_results JSON-RPC method. Complete guide on how to use block_results JSON-RPC in GetBlock Web3 documentation.

Returns the results of all transactions in a block: per-tx execution results, and the block's finalize-block events and validator/consensus-param updates.

Method

block_results

Parameters

Parameter
Type
Description

height

string

Block height (omit for latest)

Example

export STABLE_TM=https://shared.ap-southeast-1.getblock.io/<ACCESS-TOKEN>/

# JSON-RPC over HTTP (POST)
curl -X POST "${STABLE_TM}" -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": "getblock.io", "method": "block_results", "params": {"height": "31378844"}}'

# URI over HTTP (GET)
curl "${STABLE_TM}block_results?height=31378844"

Response

Response Fields

Field
Type
Description

height

string

The block height

txs_results

array

Per-transaction results: code, gas, and events

finalize_block_events

array

Block-level events emitted during finalization

Use Cases

  • Event indexing: Read transaction and block events for indexing

  • Receipt data: Inspect per-tx result codes and gas usage

Error Handling

Error
Message
Description

-32600 / Invalid request

Invalid request

The JSON-RPC envelope was malformed

-32602 / Invalid params

Invalid params

A parameter was missing or of the wrong type

403 / RBAC: access denied

Access denied

The GetBlock access token is missing or incorrect

Last updated

Was this helpful?