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

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
curl
curl -X GET "https://api.mainnet.hiro.so/extended/v2/burn-blocks/42000/blocks"

GET request that returns blocks

Example response
{
  "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
    }
  ]
}