Get block by burnchain block height

Retrieves block details of a specific block for a given burnchain block height.

GET
/extended/v1/block/by_burn_block_height/{burn_block_height}

Path Parameters

burn_block_heightinteger

Height of the burn chain block

Response Body

A block

TypeScript Definitions

Use the response body type in TypeScript.

canonicalboolean

Set to true if block corresponds to the canonical chain tip

heightinteger

Height of the block

hashstring

Hash representing the block

block_timenumber

Unix timestamp (in seconds) indicating when this block was mined.

block_time_isostring

An ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) indicating when this block was mined.

tenure_heightinteger

The tenure height (AKA coinbase height) of this block

index_block_hashstring

The only hash that can uniquely identify an anchored block or an unconfirmed state trie

parent_block_hashstring

Hash of the parent block

burn_block_timenumber

Unix timestamp (in seconds) indicating when this block was mined.

burn_block_time_isostring

An ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) indicating when this block was mined.

burn_block_hashstring

Hash of the anchor chain block

burn_block_heightinteger

Height of the anchor chain block

miner_txidstring

Anchor chain transaction ID

execution_cost_read_countinteger

Execution cost read count.

execution_cost_read_lengthinteger

Execution cost read length.

execution_cost_runtimeinteger

Execution cost runtime.

execution_cost_write_countinteger

Execution cost write count.

execution_cost_write_lengthinteger

Execution cost write length.

txsarray<string>

List of transactions included in the block

parent_microblock_hashstring

The hash of the last streamed block that precedes this block to which this block is to be appended. Not every anchored block will have a parent microblock stream. An anchored block that does not have a parent microblock stream has the parent microblock hash set to an empty string, and the parent microblock sequence number set to -1.

parent_microblock_sequenceinteger

The hash of the last streamed block that precedes this block to which this block is to be appended. Not every anchored block will have a parent microblock stream. An anchored block that does not have a parent microblock stream has the parent microblock hash set to an empty string, and the parent microblock sequence number set to -1.

microblocks_acceptedarray<string>

List of microblocks that were accepted in this anchor block. Not every anchored block will have a accepted all (or any) of the previously streamed microblocks. Microblocks that were orphaned are not included in this list.

microblocks_streamedarray<string>

List of microblocks that were streamed/produced by this anchor block's miner. This list only includes microblocks that were accepted in the following anchor block. Microblocks that were orphaned are not included in this list.

microblock_tx_countobject

List of txs counts in each accepted microblock

Empty Object

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

errorstring
message?string
[key: string]any
curl -X GET "https://api.hiro.so//extended/v1/block/by_burn_block_height/744603"
fetch("https://api.hiro.so//extended/v1/block/by_burn_block_height/744603")
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://api.hiro.so//extended/v1/block/by_burn_block_height/744603"

  req, _ := http.NewRequest("GET", url, nil)
  
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://api.hiro.so//extended/v1/block/by_burn_block_height/744603"

response = requests.request("GET", url)

print(response.text)
{
  "canonical": true,
  "height": 0,
  "hash": "string",
  "block_time": 0,
  "block_time_iso": "string",
  "tenure_height": 0,
  "index_block_hash": "string",
  "parent_block_hash": "string",
  "burn_block_time": 0,
  "burn_block_time_iso": "string",
  "burn_block_hash": "string",
  "burn_block_height": 0,
  "miner_txid": "string",
  "execution_cost_read_count": 0,
  "execution_cost_read_length": 0,
  "execution_cost_runtime": 0,
  "execution_cost_write_count": 0,
  "execution_cost_write_length": 0,
  "txs": [
    "string"
  ],
  "parent_microblock_hash": "string",
  "parent_microblock_sequence": 0,
  "microblocks_accepted": [
    "string"
  ],
  "microblocks_streamed": [
    "string"
  ],
  "microblock_tx_count": {
    "property1": 0,
    "property2": 0
  }
}
{
  "error": "string",
  "message": "string"
}
Get block by burnchain block hashGet burn blocks