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.
X-API-Key<token>
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
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/api/v2/getBlockHeader" \ -H "Content-Type: application/json" \ -d '{ "workchain": "string", "shard": "string", "seqno": "string" }'{ "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"}