Get block header
Returns block metadata without the full transaction list. Includes timestamps, validator info, and references to previous blocks. Intended for block explorers and other use cases that require block information without transactions.
API key header of the form X-API-Key: <token>, where <token> is the API key. Requests without a key are limited to 1 RPS. Refer to the authentication guide for details.
In: header
Query Parameters
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.
The shard identifier. Masterchain always uses -9223372036854775808. For basechain, shards split and merge dynamically. Use the shards endpoint to discover current shard configuration.
Masterchain block sequence number (block height). Used to query state at a specific point in time. If omitted, returns the current state.
The block's root hash for verification. Together with file_hash, this uniquely and cryptographically identifies a block. Only needed when proof of block identity is required.
The block's file hash for verification. Together with root_hash, this provides cryptographic proof of block identity. Only needed for trustless verification.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/getBlockHeader?workchain=0&shard=string&seqno=0"{
"ok": true,
"result": {
"@type": "blocks.header",
"id": {
"@type": "ton.blockIdExt",
"workchain": 0,
"shard": "string",
"seqno": 0,
"root_hash": "string",
"file_hash": "string"
},
"global_id": 0,
"version": 0,
"after_merge": true,
"after_split": true,
"before_split": true,
"want_merge": true,
"want_split": true,
"validator_list_hash_short": 0,
"catchain_seqno": 0,
"min_ref_mc_seqno": 0,
"is_key_block": true,
"prev_key_block_seqno": 0,
"start_lt": "string",
"end_lt": "string",
"gen_utime": 0,
"prev_blocks": [
{
"@type": "ton.blockIdExt",
"workchain": 0,
"shard": "string",
"seqno": 0,
"root_hash": "string",
"file_hash": "string"
}
]
},
"@extra": "string"
}{
"ok": false,
"code": 401,
"error": "API key does not exist"
}{
"ok": false,
"code": 403,
"error": "Network not allowed"
}{
"ok": false,
"code": 422,
"error": "workchain required"
}{
"ok": false,
"code": 429,
"error": "Ratelimit exceeded"
}{
"ok": false,
"code": 504,
"error": "LITE_SERVER_NETWORK timeout"
}