Get block header metadata

Get metadata of a given block.

GET /getBlockHeader

Try it

Get block header metadata

cURL

curl --request GET \
  --url https://toncenter.com/api/v2/getBlockHeader

200

{
  "ok": true,
  "result": {
    "@type": "blocks.header",
    "id": {
      "@type": "ton.blockIdExt",
      "workchain": -1,
      "shard": "-9223372036854775808",
      "seqno": 1,
      "root_hash": "8GYhhrigd8CwZGrRT59iulLDcgiTYuvOAzFJxugc0Ts=",
      "file_hash": "V+XzykEwun4yePZhAEPZk77RbMfMOgS/S4GiJkSKY6s="
    },
    "global_id": -239,
    "version": 0,
    "after_merge": false,
    "after_split": false,
    "before_split": false,
    "want_merge": false,
    "want_split": false,
    "validator_list_hash_short": -1447544682,
    "catchain_seqno": 0,
    "min_ref_mc_seqno": 1,
    "is_key_block": false,
    "prev_key_block_seqno": 0,
    "start_lt": "1000000",
    "end_lt": "1000012",
    "gen_utime": 1573822385,
    "prev_blocks": [
      {
        "@type": "ton.blockIdExt",
        "workchain": -1,
        "shard": "-9223372036854775808",
        "seqno": 0,
        "root_hash": "F6OpKZKqvqeFp6CQmFomXNMfMj2EnaUSOXN+Mh+wVWk=",
        "file_hash": "XplPz01CXAps5qeSWUtxcyBfdAo5zVb1N979KLSKD24="
      }
    ],
    "@extra": "1755814930.1088252:0:0.1467032130574265"
  }
}

Query Parameters

workchain · integer · required

shard · integer · required

seqno · integer · required

root_hash · string

file_hash · string

Response

200

application/json

Successful Response

ok · boolean · required

result · Result · object

Header information of the specified block.

Show child attributes

result. id · object · required

Extended identifier of the block.

Show child attributes

result.id. workchain · integer · required

result.id. shard · string · required

64-bit signed integer as string

result.id. seqno · integer · required

result.id. root_hash · string · required

result.id. file_hash · string · required

result.id. @type · string

Example:

"ton.blockIdExt"

result. global_id · integer · required

Global network identifier.

result. version · integer · required

Block format version.

result. gen_utime · integer · required

Block generation UNIX timestamp.

result. @type · string

Example:

"blocks.header"

result. after_merge · boolean

True if block was created after a merge.

result. after_split · boolean

True if block was created after a split.

result. before_split · boolean

True if block was created before a split.

result. want_merge · boolean

Indicates if validators wanted a merge.

result. want_split · boolean

Indicates if validators wanted a split.

result. validator_list_hash_short · integer

Short hash of validator list.

result. catchain_seqno · integer

Catchain sequence number.

result. min_ref_mc_seqno · integer

Minimum referenced masterchain seqno.

result. is_key_block · boolean

True if this block is a key block.

result. prev_key_block_seqno · integer

Previous key block sequence number.

result. start_lt · string

Starting logical time.

result. end_lt · string

Ending logical time.

result. prev_blocks · object[]

List of previous block identifiers.

Show child attributes

result.prev_blocks. workchain · integer · required

result.prev_blocks. shard · string · required

64-bit signed integer as string

result.prev_blocks. seqno · integer · required

result.prev_blocks. root_hash · string · required

result.prev_blocks. file_hash · string · required

result.prev_blocks. @type · string

Example:

"ton.blockIdExt"

result. @extra · string

Extra metadata for the response.

error · string

code · integer