/getBlockHeader REST API Endpoint
Query Parameters
workchain
integer
REQUIRED
Identifies the workchain
shard
string
REQUIRED
The shard identifier
seqno
integer
REQUIRED
The sequence number of the block
root_hash
string
The root hash of the block
file_hash
string
The file hash of the block
Returns
ok
boolean
Indicates whether the response was successful
result
object
The result object which contains the following fields:
@type
string
Specifies the type of result
id
object
The id object which contains the following fields:
@type
string
Specifies the type of block ID
workchain
integer
Identifies the workchain
shard
string
The shard identifier
seqno
integer
The sequence number of the block
root_hash
string
The root hash of the block
file_hash
string
The file hash of the block
global_id
integer
The global identifier for the blockchain
version
integer
The version number of the block
flags
integer
Flags representing special properties of the block
after_merge
boolean
Indicates if the block was produced after a merge
after_split
boolean
Indicates if the block was produced after a split
before_split
boolean
Indicates if the block was produced before a split
want_merge
boolean
Indicates if a merge is desired
want_split
boolean
Indicates if a split is desired
validator_list_hash_short
integer
A shortened hash of the validator list
catchain_seqno
integer
The sequence number in the catchain
min_ref_mc_seqno
integer
The minimum reference masterchain block sequence number
is_key_block
boolean
Indicates whether the block is a key block
prev_key_block_seqno
integer
The sequence number of the previous key block
start_lt
string
The logical time (lt) at the start of the block
end_lt
string
The logical time (lt) at the end of the block
gen_utime
integer
The Unix timestamp for block generation
vert_seqno
integer
The vertical sequence number
prev_blocks
array
An array of prev_blocks
@type
string
Specifies the type of the previous block ID
workchain
integer
Identifies the workchain of the previous block
shard
string
The shard identifier for the previous block
seqno
integer
The sequence number of the previous block
root_hash
string
The root hash of the previous block
file_hash
string
The file hash of the previous block
@extra
string
Additional metadata related to the block header query
Request
1curl --location 'https://docs-demo.ton-mainnet.quiknode.pro/getBlockHeader?workchain=-1&shard=-9223372036854775808&seqno=40921421&root_hash=ds7MSTUkR4wntgiCKkjgl8vrXoSSaCEF2emIu9BlELE' \2--header 'accept: application/json'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free