1 of 1

Get Blocks

Returns a list of blocks on the network.

This method will use 15 Compute Units.

Get Blocks

Returns a list of blocks on the network.

This method will use 15 Compute Units.

List blocks

Returns a list of blocks on the network.

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/blocks

Query parameters

block.numberstring

The block's number

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

limitinteger (int32)

The maximum number of items to return

Example: 2

orderenum

The order in which items are listed

Example: "asc"

ascdesc

timestamparray of string

The consensus timestamp in seconds.nanoseconds format with an optional comparison operator

itemsstring

Pattern: ^((eq|gt|gte|lt|lte|ne):)?\d{1,10}(.\d{1,9})?$

Response

Body

blocksBlocks (array of Block (object))

countinteger

gas_usednullable integer (int64)

hapi_versionnullable string

hashstring

logs_bloomnullable string

A hex encoded 256-byte array with 0x prefix

Pattern: ^0x[0-9a-fA-F]{512}$

namestring

numberinteger

previous_hashstring

sizenullable integer

timestampobject

fromTimestampRange (object)

A timestamp range an entity is valid for

fromall of

Timestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

any

The inclusive from timestamp in seconds

toall of

nullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

any

The exclusive to timestamp in seconds

toTimestampRange (object)

A timestamp range an entity is valid for

fromall of

Timestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

any

The inclusive from timestamp in seconds

toall of

nullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

any

The exclusive to timestamp in seconds

linksLinks (object)

nextnullable string

Example: "/api/v1/transactions?timestamp=lt:1657598275.517984411"

Request

Response

List blocks

Returns a list of blocks on the network.

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/blocks

Query parameters

block.numberstring

The block's number

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

limitinteger (int32)

The maximum number of items to return

Example: 2

orderenum

The order in which items are listed

Example: "asc"

ascdesc

timestamparray of string

The consensus timestamp in seconds.nanoseconds format with an optional comparison operator

itemsstring

Pattern: ^((eq|gt|gte|lt|lte|ne):)?\d{1,10}(.\d{1,9})?$

Response

Body

blocksBlocks (array of Block (object))

countinteger

gas_usednullable integer (int64)

hapi_versionnullable string

hashstring

logs_bloomnullable string

A hex encoded 256-byte array with 0x prefix

Pattern: ^0x[0-9a-fA-F]{512}$

namestring

numberinteger

previous_hashstring

sizenullable integer

timestampobject

fromTimestampRange (object)

A timestamp range an entity is valid for

fromall of

Timestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

any

The inclusive from timestamp in seconds

toall of

nullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

any

The exclusive to timestamp in seconds

toTimestampRange (object)

A timestamp range an entity is valid for

fromall of

Timestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

any

The inclusive from timestamp in seconds

toall of

nullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

any

The exclusive to timestamp in seconds

linksLinks (object)

nextnullable string

Example: "/api/v1/transactions?timestamp=lt:1657598275.517984411"

Request

Response

const response = await fetch('https://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/blocks', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

{
  "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": "/api/v1/transactions?timestamp=lt:1657598275.517984411"
  }
}