Skip to main content
GET
/
api
/
v2
/
getBlockHeader
Get block header
curl --request GET \
  --url https://toncenter.com/api/v2/getBlockHeader \
  --header 'X-API-Key: <api-key>'
{
  "ok": true,
  "result": {
    "@type": "blocks.header",
    "id": {
      "@type": "ton.blockIdExt",
      "workchain": 123,
      "shard": "<string>",
      "seqno": 123,
      "root_hash": "<string>",
      "file_hash": "<string>"
    },
    "global_id": 123,
    "version": 123,
    "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>",
    "gen_utime": 123,
    "prev_blocks": [
      {
        "@type": "ton.blockIdExt",
        "workchain": 123,
        "shard": "<string>",
        "seqno": 123,
        "root_hash": "<string>",
        "file_hash": "<string>"
      }
    ]
  },
  "@extra": "<string>"
}

Authorizations

​
X-API-Key
string
header
required

API key header of the form X-API-Key: <token>, where <token> is your API key. Requests without a key are limited to 1 RPS. More info here.

Query Parameters

​
workchain
integer<int32>
required

The workchain to query. Use -1 for masterchain (validators, system contracts, config) or 0 for basechain (regular accounts and contracts). Most user transactions happen on workchain 0.

​
shard
string
required

The shard identifier. Masterchain always uses -9223372036854775808. For basechain, shards split and merge dynamically. Use the shards endpoint to discover current shard configuration.

​
seqno
integer<int32>
required

Masterchain block sequence number (block height). Used to query state at a specific point in time. If omitted, returns the current state.

​
root_hash
string

The block's root hash for verification. Together with file_hash, this uniquely and cryptographically identifies a block. Only needed when you require proof of block identity.

​
file_hash
string

The block's file hash for verification. Together with root_hash, this provides cryptographic proof of block identity. Only needed for trustless verification.

Response

Returns the block header with merge/split flags, validator info, and timing data.

​
ok
boolean
default:true
required

Returns true if the request succeeded; otherwise false. See the error field for details.

​
result
object
required

Response data. Present only when ok is true.

​
@extra
string

Optional request ID that you can pass in the request and receive back in the response. Useful for matching async responses.