Skip to main content

eth_getBlockByNumber RPC Method

Returns information of the block matching the given block number.

Updated on
Mar 27, 2026

Parameters

blockNumber/tag
string
REQUIRED

The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized

transaction detail flag
boolean
REQUIRED

The method returns the full transaction objects when this value is true otherwise, it returns only the hashes of the transactions

Returns

object
object

A block object, or null when no block was found

baseFeePerGas
string

(Optional) The base fee per gas encoded in hexadecimal format. This field is omitted for blocks before the EIP-1559 upgrade

difficulty
string

The difficulty of this block encoded as a hexadecimal value

extraData
string

The extra data field of this block

gasLimit
string

The maximum gas allowed in this block encoded as a hexadecimal value

gasUsed
string

The total gas used by all transactions in this block encoded as a hexadecimal value

hash
string

The block hash of the requested block or null if pending

logsBloom
string

The bloom filter for the logs of the block or null if pending

miner
string

The address of the beneficiary to whom the mining rewards were given

mixHash
string

The 256-bit hash used in proof-of-work encoded as a hexadecimal value

nextL1MsgIndex
string

The next L1 message index encoded as a hexadecimal value

nonce
string

The hash of the generated proof-of-work or null if pending

number
string

The block number encoded as a hexadecimal value or null if pending

parentHash
string

The hash of the parent block

receiptsRoot
string

The root of the receipts trie of the block

sha3Uncles
string

The SHA3 of the uncles data in the block

size
string

The size of this block in bytes encoded as a hexadecimal value

stateRoot
string

The root of the final state trie of the block

timestamp
string

The Unix timestamp for when the block was collated encoded as a hexadecimal value

totalDifficulty
string

The total difficulty of the chain until this block encoded as a hexadecimal value

transactions
array

The array of transaction objects or hashes included in the block

transactionsRoot
string

The root of the transaction trie of the block

uncles
array

The array of uncle hashes included in the block

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": {
5
"baseFeePerGas": "0xf4240",
6
"difficulty": "0x0",
7
"extraData": "0x",
8
"gasLimit": "0x1c9c380",
9
"gasUsed": "0x15a5d",
10
"hash": "0x7fb636698d5ad9b549795b4b543b055be2f26c80f15a4894abb898d256f03ab7",
11
"logsBloom": "0x00000000000000010100000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000801000000008000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000010000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000",
12
"miner": "0x0000000000000000000000000000000000000000",
13
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
14
"nextL1MsgIndex": "0x633c",
15
"nonce": "0x0000000000000000",
16
"number": "0x11656f6",
17
"parentHash": "0xfaab46b861b62bb05440d67657a0fd49f28997c8409ca2bd829db2ff1099f439",
18
"receiptsRoot": "0x25bb6599ecdd7612d6ae3229e921f19de476ad4df96a25c78d5d210c7f35ce9d",
19
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
20
"size": "0x55e",
21
"stateRoot": "0x2d9836cac4e66d633f4da46cd5fc18ecb9e5cacdd9596cbbb0ea7d6e7b9818fb",
22
"timestamp": "0x6909eb2d",
23
"totalDifficulty": "0x0",
24
"transactions": [
25
"0x8579b7dec12e69dc9355c42e3989b295eadf84cd26ea04df369a881359672654"
26
],
27
"transactionsRoot": "0x74833714254e93eb3e6652de78de4318afc471811ebc8f0e658b176860fa638d",
28
"uncles": []
29
}
30
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": {
5
"baseFeePerGas": "0xf4240",
6
"difficulty": "0x0",
7
"extraData": "0x",
8
"gasLimit": "0x1c9c380",
9
"gasUsed": "0x15a5d",
10
"hash": "0x7fb636698d5ad9b549795b4b543b055be2f26c80f15a4894abb898d256f03ab7",
11
"logsBloom": "0x00000000000000010100000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000801000000008000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000010000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000",
12
"miner": "0x0000000000000000000000000000000000000000",
13
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
14
"nextL1MsgIndex": "0x633c",
15
"nonce": "0x0000000000000000",
16
"number": "0x11656f6",
17
"parentHash": "0xfaab46b861b62bb05440d67657a0fd49f28997c8409ca2bd829db2ff1099f439",
18
"receiptsRoot": "0x25bb6599ecdd7612d6ae3229e921f19de476ad4df96a25c78d5d210c7f35ce9d",
19
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
20
"size": "0x55e",
21
"stateRoot": "0x2d9836cac4e66d633f4da46cd5fc18ecb9e5cacdd9596cbbb0ea7d6e7b9818fb",
22
"timestamp": "0x6909eb2d",
23
"totalDifficulty": "0x0",
24
"transactions": [
25
"0x8579b7dec12e69dc9355c42e3989b295eadf84cd26ea04df369a881359672654"
26
],
27
"transactionsRoot": "0x74833714254e93eb3e6652de78de4318afc471811ebc8f0e658b176860fa638d",
28
"uncles": []
29
}
30
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free