Skip to main content

/block/{height_or_hash} REST API Endpoint

Returns the block data for a specific block identified by its height or hash.

Updated on
Jul 07, 2026

Path Parameters

height_or_hash
string
REQUIRED

The block height (integer) or block hash (string) to query

Returns

block_hash
string

The unique hash identifier of the block

previous_hash
string

The hash of the previous block in the chain

header
object

The block header containing state roots, Merkle roots, and metadata

previous_state_root
string

The state root of the previous block

transactions_root
string

The Merkle root of the transactions in the block

finalize_root
string

The root hash of the finalize operations

ratifications_root
string

The root hash of the ratifications

solutions_root
string

The root hash of the solutions

subdag_root
string

The root hash of the subDAG

metadata
object

Block metadata including network, round, height, weight, targets, and timestamps

network
integer

The network identifier (0 for mainnet)

round
integer

The consensus round number

height
integer

The block height

cumulative_weight
string

The cumulative weight of the chain up to this block

cumulative_proof_target
string

The cumulative proof target up to this block

coinbase_target
integer

The coinbase target for this block

proof_target
integer

The proof target for this block

last_coinbase_target
integer

The coinbase target of the last coinbase block

last_coinbase_timestamp
integer

The Unix timestamp of the last coinbase block

timestamp
integer

The Unix timestamp of this block

authority
object

The authority information for the block containing the quorum subDAG with validator batch certificates

type
string

The type of authority (e.g., 'quorum')

subdag
object

The subDAG structure containing batch certificates organized by round

subdag
object

An object keyed by round number, where each value is an array of batch certificates from validators for that round

{round_number}
array

Array of batch certificate objects for this round

batch_header
object

The batch header containing batch metadata, transmission IDs, and validator signature

batch_id
string

The unique identifier for this batch

author
string

The address of the validator that authored this batch

round
integer

The consensus round number for this batch

timestamp
integer

The Unix timestamp when this batch was created

committee_id
string

The identifier of the committee for this batch

transmission_ids
array

Array of transmission IDs included in this batch (transaction and solution identifiers)

previous_certificate_ids
array

Array of certificate IDs from the previous round referenced by this batch

signature
string

The cryptographic signature of the batch header

signatures
array

Array of validator signatures attesting to this batch certificate

ratifications
array

Array of ratification entries (e.g., block_reward, puzzle_reward)

type
string

The type of ratification (e.g., 'block_reward', 'puzzle_reward')

amount
integer

The amount in microcredits for this ratification

solutions
object

The puzzle solutions included in the block

version
integer

The version number of the solutions format

solutions
object

The solutions container (present when there are puzzle solutions)

solutions
array

Array of solution objects

partial_solution
object

The partial solution submitted by a prover

solution_id
string

The unique identifier for this solution

epoch_hash
string

The epoch hash used for this solution

address
string

The address of the prover who submitted this solution

counter
integer

The counter value used in the proof-of-work

target
integer

The target value achieved by this solution

aborted_solution_ids
array

Array of solution IDs that were aborted in this block

transactions
array

Array of confirmed transactions included in the block

status
string

The confirmation status of the transaction (e.g., 'accepted', 'rejected')

type
string

The type of the confirmed transaction (e.g., 'execute', 'deploy')

index
integer

The index of the transaction within the block

transaction
object

The full transaction object containing ID, type, execution details, and fee

type
string

The type of the transaction (e.g., 'execute', 'deploy')

id
string

The unique transaction identifier

execution
object

The execution details including transitions and proof (present for execute transactions)

transitions
array

Array of transition objects representing state changes

id
string

The unique transition identifier

program
string

The program ID that was called (e.g., 'credits.aleo')

function
string

The function name that was executed

inputs
array

Array of input objects for this transition

type
string

The type of input (e.g., 'public', 'private', 'record', 'external_record')

id
string

The unique identifier for this input

value
string

The value of the input

outputs
array

Array of output objects from this transition

type
string

The type of output (e.g., 'future', 'public', 'private', 'record', 'external_record')

id
string

The unique identifier for this output

value
string

The value of the output

tpk
string

The transition public key

tcm
string

The transition commitment

scm
string

The signer commitment

global_state_root
string

The global state root at the time of execution

proof
string

The zero-knowledge proof of execution

fee
object

The fee details for the transaction including the fee transition and proof

transition
object

The fee transition details

id
string

The unique transition identifier

program
string

The program ID that was called (e.g., 'credits.aleo')

function
string

The function name that was executed

inputs
array

Array of input objects for this transition

type
string

The type of input (e.g., 'public', 'private', 'record', 'external_record')

id
string

The unique identifier for this input

value
string

The value of the input

outputs
array

Array of output objects from this transition

type
string

The type of output (e.g., 'future', 'public', 'private', 'record', 'external_record')

id
string

The unique identifier for this output

value
string

The value of the output

tpk
string

The transition public key

tcm
string

The transition commitment

scm
string

The signer commitment

global_state_root
string

The global state root at the time of the fee payment

proof
string

The zero-knowledge proof for the fee transition

finalize
array

Array of finalize operations recording state changes to on-chain mappings

type
string

The type of finalize operation (e.g., 'update_key_value', 'insert_key_value', 'remove_key_value')

mapping_id
string

The identifier of the mapping being modified

key_id
string

The identifier of the key in the mapping

value_id
string

The identifier of the value in the mapping

aborted_transaction_ids
array

Array of transaction IDs that were aborted in this block

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free