Skip to main content

blockchain REST API Endpoint

Retrieves block headers for minHeight <= height <= maxHeight.

Updated on
Mar 17, 2026
Please note that for this method, at most 20 items will be returned for the minHeight or maxHeight parameters specified. If maxHeight does not yet exist, the blocks up to the current height will be returned. If minHeight does not exist due to pruning, the earliest existing height will be used.

Query Parameters

minHeight
integer

The minimum block height to return

maxHeight
integer

The maximum block height to return

Returns

result
object

The result object which contains the following fields:

last_height
string

The last height of the block

block_metas
array

The meta data about the blocks

block_id
object

The block_id object which contains the information about the block's ID

hash
string

The hash of the block

parts
object

The parts object which contains the information about the parts of the block

total
integer

The total number of parts

hash
string

The hash of the parts

block_size
string

The size of the block in bytes

header
object

The header object which contains the information about the block header

version
object

The version of the block and the application

block
string

The block version

app
string

(Optional) The application version

chain_id
string

The ID of the blockchain

height
string

The height of the block

time
string

The time at which the block was created

last_block_id
object

The last_block_id object which contains the information about the last block's ID

hash
string

The hash of the last block

parts
string

The parts object which contains the information about the parts of the last block

total
integer

The total number of parts of the last block

hash
string

The hash of the parts of the last block

last_commit_hash
string

The hash of the last commit

data_hash
string

The hash of the block's data

validators_hash
string

The hash of the validators

next_validators_hash
string

The hash of the next validators

consensus_hash
string

The hash of the consensus

app_hash
string

The hash of the application

last_results_hash
string

The hash of the last results

evidence_hash
string

The hash of the evidence

proposer_address
string

The address of the proposer

randao_mix
string

A randomness value included in the block, derived from the beacon chain RANDAO process and used as part of Ethereum’s proof-of-stake randomness generation mechanism

num_txs
string

The number of transactions in the block

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free