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": {
    "id": {
      "workchain": 123,
      "shard": "<string>",
      "seqno": 123,
      "root_hash": "<string>",
      "file_hash": "<string>",
      "@type": "ton.blockIdExt"
    },
    "global_id": 123,
    "version": 123,
    "gen_utime": 123,
    "@type": "blocks.header",
    "after_merge": true,
    "after_split": true,
    "before_split": true,
    "want_merge": true,
    "want_split": true,
    "validator_list_hash_short": 123,
    "catchain_seqno": 123,
    "min_ref_mc_seqno": 123,
    "is_key_block": true,
    "prev_key_block_seqno": 123,
    "start_lt": "<string>",
    "end_lt": "<string>",
    "prev_blocks": [
      {
        "workchain": 123,
        "shard": "<string>",
        "seqno": 123,
        "root_hash": "<string>",
        "file_hash": "<string>",
        "@type": "ton.blockIdExt"
      }
    ],
    "@extra": "<string>"
  },
  "error": "<string>",
  "code": 123
}

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