Get blocks by burn block

Retrieves a list of blocks confirmed by a specific burn block.


GET
/extended/v2/burn-blocks/{height_or_hash}/blocks

Get blocks by burn block

Retrieves a list of blocks confirmed by a specific burn block

Path Parameters

height_or_hash
Required
integer | string

filter by burn block height, hash, or the constant latest to filter for the most recent burn block

Query Parameters

limitinteger

max number of blocks to fetch

Example: 20

offsetinteger

index of first burn block to fetch

Example: 0
Status codeDescription
200List of blocks
/extended/v2/burn-blocks/{height_or_hash}/blocks

Terminal
$
curl -X GET "https://api.hiro.so/extended/v2/burn-blocks/42000/blocks?limit=20&offset=0"

GET request that returns blocks

{
"limit": 30,
"offset": 0,
"total": 0,
"results": [
{
"canonical": true,
"height": 0,
"hash": "string",
"block_time": 0,
"block_time_iso": "string",
"index_block_hash": "string",
"parent_block_hash": "string",
"parent_index_block_hash": "string",
"burn_block_time": 0,
"burn_block_time_iso": "string",
"burn_block_hash": "string",
"burn_block_height": 0,
"miner_txid": "string",
"tx_count": 0,
"execution_cost_read_count": 0,
"execution_cost_read_length": 0,
"execution_cost_runtime": 0,
"execution_cost_write_count": 0,
"execution_cost_write_length": 0
}
]
}