blocks

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.

get/api/v2/getBlockHeader

Request

  • Base URL: https://toncenter.com (the document declares no server; this is the origin it was published from)
  • URL: https://toncenter.com/api/v2/getBlockHeader
  • Auth: one of:
    • API key in header X-API-Key
    • API key in query parameter api_key

Query parameters

workchaininteger 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.

shardstring required

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

seqnointeger required

Block sequence number within the specified workchain and shard.

root_hashstring

The block's root hash. Together with file_hash, uniquely identifies a block.

file_hashstring

The block's file hash. Together with root_hash, uniquely identifies a block.

Response

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

okboolean required

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

@extrastring required
jsonrpcstring

JSON-RPC protocol version identifier.

idstring

Changes

No recorded changes to this operation across all 1 revision of this API.