> For the complete documentation index, see [llms.txt](https://docs.getblock.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getblock.io/api-reference/cosmos/tendermint-rpc-api/block_results-cosmos.md).

# block\_results - Cosmos

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

{% code overflow="wrap" %}

```bash
export COSMOS_TM=https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/

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

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

{% endcode %}

## Response

```json
{
  "jsonrpc": "2.0",
  "id": "getblock.io",
  "result": {
    "height": "31378844",
    "txs_results": [
      {
        "code": 0,
        "gas_used": "84000",
        "events": []
      }
    ],
    "finalize_block_events": []
  }
}
```

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