Skip to main content

Get Block from Ledger

Returns an object containing various details about a specific block on the Ledger.

Request Body
block_num_or_id integer REQUIRED

Provide a block number or a block id

Responses
200

OK

Schema
timestamp DateTimeSeconds

Date/time string in the format YYYY-MM-DDTHH:MM:SS.sss

master string

Possible values: Value must match regular expression ^[a-z]{1}[a-z1-5.]{1,10}[a-z1-5]{1}$

String representation of an Inery database name.

confirmed integer

number of prior blocks confirmed by this block master in current schedule

previous string

Possible values: Value must match regular expression ^[0-9A-Fa-f]{64}$

SHA-256 hash representing the code.

transaction_mroot string

Possible values: Value must match regular expression ^[0-9A-Fa-f]{64}$

SHA-256 hash representing the code.

action_mroot string

Possible values: Value must match regular expression ^[0-9A-Fa-f]{64}$

SHA-256 hash representing the code.

schedule_version integer

number of times master schedule has changed since genesis

new_masterss (circular)
header_extensions undefined[]
new_protocol_features object[]

list of new protocol features

masters_signature string[]

Possible values: Value must match regular expression ^SIG_([RK]1|WA)_[1-9A-HJ-NP-Za-km-z]+$

transactions object[]

list of valid transaction receipts included in block

status string

Possible values: [executed, soft_fail, hard_fail, delayed, expired]

status:

  • executed - Succeed, no error handler executed
  • soft_fail - Objectively failed (not executed), error handler executed
  • hard_fail - Objectively failed and error handler objectively failed thus no state change
  • delayed - Used by delayed-user transactions for timer-based executions
  • expired - Transaction expired and storage space refunded to user
cpu_usage_us integer
net_usage_words integer
trx TransactionVariant
block_extensions undefined[]
id string

Possible values: Value must match regular expression ^[0-9A-Fa-f]{64}$

SHA-256 hash representing the code.

block_num integer

height of this block in the chain

ref_block_prefix integer

32-bit portion of block ID