Blocks

Overview

The Block endpoints in the Hedera Mirror Node REST API allows developers to query block data on the Hedera network. These endpoints are essential for retrieving block metadata, including hashes, timestamps, and transactions within blocks.

Endpoints

The following Block endpoints are available:

Endpoint	Description
GET /api/v1/blocks	Retrieves a list of blocks on the network.
GET /api/v1/blocks/{hash_or_number}	Fetches details of a specific block by hash or block number.

Blocks

List blocks

get

Returns a list of blocks on the network.

Query parameters

block.numberstringoptional

The block's number

Example: {"summary":"--","value":""}

Pattern: ^((eq|gt|gte|lt|lte):)?\d{1,19}$

limitinteger · int32 · min: 1 · max: 100 · default: 25optional

The maximum number of items to return

Example: 2

orderundefined · enum · default: "desc"optional

The order in which items are listed

Example: asc

Available options:

timestampstring[]optional

The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

Example: {"summary":"--","value":""}

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/blocks'

200

400

200

{
  "blocks": [
    {
      "count": 3,
      "gas_used": 300000,
      "hapi_version": "0.11.0",
      "hash": "0x3c08bbbee74d287b1dcd3f0ca6d1d2cb92c90883c4acf9747de9f3f3162ad25b999fc7e86699f60f2a3fb3ed9a646c6b",
      "logs_bloom": "0x00000020002000001000000000000000000000000000000000000000000010000000000004000000000000000000000000108000000000000000000080000000000004000000000000000000000000880000000000000000000101000000000000000000000000000000000000008000000000000400000080000000000001000000000000000000000000000000000000000000002000000000100000100000200000040000100000001000000000000000000000000000000001001000004000000000000000000001000000000000000000100000000000100000000000000000000000000000000000000000000000080000100800000000000000120080",
      "name": "2022-05-03T06_46_26.060890949Z.rcd",
      "number": 77,
      "previous_hash": "0xf7d6481f659c866c35391ee230c374f163642ebf13a5e604e04a95a9ca48a298dc2dfa10f51bcbaab8ae23bc6d662a0b",
      "size": 8192,
      "timestamp": {
        "from": "1651560386.060890949",
        "to": "1651560386.661997287"
      }
    }
  ],
  "links": {
    "next": null
  }
}

OK

Get block by hash or number

get

Returns the block information by given hash or number.

Path parameters

hashOrNumberstringrequired

Accepts both eth and hedera hash format or block number

Pattern: ^(\d{1,10}|(0x)?([A-Fa-f0-9]{64}|[A-Fa-f0-9]{96}))$

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/v1/blocks/{hashOrNumber}'

200

400

404

200

{
  "count": 3,
  "gas_used": 300000,
  "hapi_version": "0.11.0",
  "hash": "0x3c08bbbee74d287b1dcd3f0ca6d1d2cb92c90883c4acf9747de9f3f3162ad25b999fc7e86699f60f2a3fb3ed9a646c6b",
  "logs_bloom": "0x00000020002000001000000000000000000000000000000000000000000010000000000004000000000000000000000000108000000000000000000080000000000004000000000000000000000000880000000000000000000101000000000000000000000000000000000000008000000000000400000080000000000001000000000000000000000000000000000000000000002000000000100000100000200000040000100000001000000000000000000000000000000001001000004000000000000000000001000000000000000000100000000000100000000000000000000000000000000000000000000000080000100800000000000000120080",
  "name": "2022-05-03T06_46_26.060890949Z.rcd",
  "number": 77,
  "previous_hash": "0xf7d6481f659c866c35391ee230c374f163642ebf13a5e604e04a95a9ca48a298dc2dfa10f51bcbaab8ae23bc6d662a0b",
  "size": 8192,
  "timestamp": {
    "from": "1651560386.060890949",
    "to": "1651560386.661997287"
  }
}

OK