Skip to main content

/extended/v1/block/by_height/{height} REST API Endpoint

Retrieves block details of a specific block at a given block height.

Updated on
Oct 4, 2023

/extended/v1/block/by_height/{height} REST API Endpoint

Path Parameters

height
integer
REQUIRED
Height of the block.

Returns

object
object
block details of the specified block at a given height
canonical
boolean
Set to true if the block corresponds to the canonical chain tip.
height
integer
Height of the block.
hash
string
Hash representing the block.
parent_block_hash
string
Hash of the parent block.
burn_block_time
number
Unix timestamp (in seconds) indicating when this block was mined.
burn_block_time_iso
string
An ISO 8601 timestamp indicating when this block was mined (YYYY-MM-DDTHH:mm:ss.sssZ).
burn_block_hash
string
Hash of the anchor chain block.
burn_block_height
integer
Height of the anchor chain block.
miner_txid
string
Anchor chain transaction ID.
parent_microblock_hash
string
The hash of the last streamed block that precedes this block to which this block is to be appended. Empty string if no parent microblock stream exists.
parent_microblock_sequence
integer
The sequence number of the last streamed block that precedes this block to which this block is to be appended. -1 if no parent microblock stream exists.
txs
array
List of transactions included in the block.
microblocks_accepted
array
List of microblocks that were accepted in this anchor block. Does not include orphaned microblocks.
microblocks_streamed
array
List of microblocks that were streamed/produced by this anchor block's miner. Only includes microblocks accepted in the following anchor block. Does not include orphaned microblocks.
execution_cost_read_count
integer
Execution cost read count.
execution_cost_read_length
integer
Execution cost read length.
execution_cost_runtime
integer
Execution cost runtime.
execution_cost_write_count
integer
Execution cost write count.
execution_cost_write_length
integer
Execution cost write length.
Request
1
curl -X 'GET' \
2
    'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v1/block/by_height/10000' \
3
    -H 'Content-Type: application/json'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free