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

1
curl --location 'https://docs-demo.ton-mainnet.quiknode.pro/getBlockHeader?workchain=-1&shard=-9223372036854775808&seqno=40921421&root_hash=ds7MSTUkR4wntgiCKkjgl8vrXoSSaCEF2emIu9BlELE' \
2
--header 'accept: application/json'

1
curl --location 'https://docs-demo.ton-mainnet.quiknode.pro/getBlockHeader?workchain=-1&shard=-9223372036854775808&seqno=40921421&root_hash=ds7MSTUkR4wntgiCKkjgl8vrXoSSaCEF2emIu9BlELE' \
2
--header 'accept: application/json'

1
const myHeaders = new Headers();
2
myHeaders.append("accept", "application/json");
3

4
const requestOptions = {
5
  method: "GET",
6
  headers: myHeaders,
7
  redirect: "follow"
8
};
9

10
fetch("https://docs-demo.ton-mainnet.quiknode.pro/getBlockHeader?workchain=-1&shard=-9223372036854775808&seqno=40921421&root_hash=ds7MSTUkR4wntgiCKkjgl8vrXoSSaCEF2emIu9BlELE", requestOptions)
11
  .then((response) => response.text())
12
  .then((result) => console.log(result))
13
  .catch((error) => console.error(error));

1
const myHeaders = new Headers();
2
myHeaders.append("accept", "application/json");
3

4
const requestOptions = {
5
  method: "GET",
6
  headers: myHeaders,
7
  redirect: "follow"
8
};
9

10
fetch("https://docs-demo.ton-mainnet.quiknode.pro/getBlockHeader?workchain=-1&shard=-9223372036854775808&seqno=40921421&root_hash=ds7MSTUkR4wntgiCKkjgl8vrXoSSaCEF2emIu9BlELE", requestOptions)
11
  .then((response) => response.text())
12
  .then((result) => console.log(result))
13
  .catch((error) => console.error(error));

1
import requests
2

3
url = "https://docs-demo.ton-mainnet.quiknode.pro/getBlockHeader?workchain=-1&shard=-9223372036854775808&seqno=40921421&root_hash=ds7MSTUkR4wntgiCKkjgl8vrXoSSaCEF2emIu9BlELE"
4

5
payload = {}
6
headers = {
7
  'accept': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers, data=payload)
11

12
print(response.text)
13

1
import requests
2

3
url = "https://docs-demo.ton-mainnet.quiknode.pro/getBlockHeader?workchain=-1&shard=-9223372036854775808&seqno=40921421&root_hash=ds7MSTUkR4wntgiCKkjgl8vrXoSSaCEF2emIu9BlELE"
4

5
payload = {}
6
headers = {
7
  'accept': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers, data=payload)
11

12
print(response.text)
13

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.ton-mainnet.quiknode.pro/getBlockHeader?workchain=-1&shard=-9223372036854775808&seqno=40921421&root_hash=ds7MSTUkR4wntgiCKkjgl8vrXoSSaCEF2emIu9BlELE")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["accept"] = "application/json"
9

10
response = http.request(request)
11
puts response.read_body
12

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.ton-mainnet.quiknode.pro/getBlockHeader?workchain=-1&shard=-9223372036854775808&seqno=40921421&root_hash=ds7MSTUkR4wntgiCKkjgl8vrXoSSaCEF2emIu9BlELE")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["accept"] = "application/json"
9

10
response = http.request(request)
11
puts response.read_body
12

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free