Path Parameters
- height_or_hashstringREQUIRED
The block height (integer) or block hash (string) to query
Returns
- block_hashstring
The unique hash identifier of the block
- previous_hashstring
The hash of the previous block in the chain
- headerobject
The block header containing state roots, Merkle roots, and metadata
- previous_state_rootstring
The state root of the previous block
- transactions_rootstring
The Merkle root of the transactions in the block
- finalize_rootstring
The root hash of the finalize operations
- ratifications_rootstring
The root hash of the ratifications
- solutions_rootstring
The root hash of the solutions
- subdag_rootstring
The root hash of the subDAG
- metadataobject
Block metadata including network, round, height, weight, targets, and timestamps
- networkinteger
The network identifier (0 for mainnet)
- roundinteger
The consensus round number
- heightinteger
The block height
- cumulative_weightstring
The cumulative weight of the chain up to this block
- cumulative_proof_targetstring
The cumulative proof target up to this block
- coinbase_targetinteger
The coinbase target for this block
- proof_targetinteger
The proof target for this block
- last_coinbase_targetinteger
The coinbase target of the last coinbase block
- last_coinbase_timestampinteger
The Unix timestamp of the last coinbase block
- timestampinteger
The Unix timestamp of this block
- authorityobject
The authority information for the block containing the quorum subDAG with validator batch certificates
- typestring
The type of authority (e.g., 'quorum')
- subdagobject
The subDAG structure containing batch certificates organized by round
- subdagobject
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_headerobject
The batch header containing batch metadata, transmission IDs, and validator signature
- batch_idstring
The unique identifier for this batch
- authorstring
The address of the validator that authored this batch
- roundinteger
The consensus round number for this batch
- timestampinteger
The Unix timestamp when this batch was created
- committee_idstring
The identifier of the committee for this batch
- transmission_idsarray
Array of transmission IDs included in this batch (transaction and solution identifiers)
- previous_certificate_idsarray
Array of certificate IDs from the previous round referenced by this batch
- signaturestring
The cryptographic signature of the batch header
- signaturesarray
Array of validator signatures attesting to this batch certificate
- ratificationsarray
Array of ratification entries (e.g., block_reward, puzzle_reward)
- typestring
The type of ratification (e.g., 'block_reward', 'puzzle_reward')
- amountinteger
The amount in microcredits for this ratification
- solutionsobject
The puzzle solutions included in the block
- versioninteger
The version number of the solutions format
- solutionsobject
The solutions container (present when there are puzzle solutions)
- solutionsarray
Array of solution objects
- partial_solutionobject
The partial solution submitted by a prover
- solution_idstring
The unique identifier for this solution
- epoch_hashstring
The epoch hash used for this solution
- addressstring
The address of the prover who submitted this solution
- counterinteger
The counter value used in the proof-of-work
- targetinteger
The target value achieved by this solution
- aborted_solution_idsarray
Array of solution IDs that were aborted in this block
- transactionsarray
Array of confirmed transactions included in the block
- statusstring
The confirmation status of the transaction (e.g., 'accepted', 'rejected')
- typestring
The type of the confirmed transaction (e.g., 'execute', 'deploy')
- indexinteger
The index of the transaction within the block
- transactionobject
The full transaction object containing ID, type, execution details, and fee
- typestring
The type of the transaction (e.g., 'execute', 'deploy')
- idstring
The unique transaction identifier
- executionobject
The execution details including transitions and proof (present for execute transactions)
- transitionsarray
Array of transition objects representing state changes
- idstring
The unique transition identifier
- programstring
The program ID that was called (e.g., 'credits.aleo')
- functionstring
The function name that was executed
- inputsarray
Array of input objects for this transition
- typestring
The type of input (e.g., 'public', 'private', 'record', 'external_record')
- idstring
The unique identifier for this input
- valuestring
The value of the input
- outputsarray
Array of output objects from this transition
- typestring
The type of output (e.g., 'future', 'public', 'private', 'record', 'external_record')
- idstring
The unique identifier for this output
- valuestring
The value of the output
- tpkstring
The transition public key
- tcmstring
The transition commitment
- scmstring
The signer commitment
- global_state_rootstring
The global state root at the time of execution
- proofstring
The zero-knowledge proof of execution
- feeobject
The fee details for the transaction including the fee transition and proof
- transitionobject
The fee transition details
- idstring
The unique transition identifier
- programstring
The program ID that was called (e.g., 'credits.aleo')
- functionstring
The function name that was executed
- inputsarray
Array of input objects for this transition
- typestring
The type of input (e.g., 'public', 'private', 'record', 'external_record')
- idstring
The unique identifier for this input
- valuestring
The value of the input
- outputsarray
Array of output objects from this transition
- typestring
The type of output (e.g., 'future', 'public', 'private', 'record', 'external_record')
- idstring
The unique identifier for this output
- valuestring
The value of the output
- tpkstring
The transition public key
- tcmstring
The transition commitment
- scmstring
The signer commitment
- global_state_rootstring
The global state root at the time of the fee payment
- proofstring
The zero-knowledge proof for the fee transition
- finalizearray
Array of finalize operations recording state changes to on-chain mappings
- typestring
The type of finalize operation (e.g., 'update_key_value', 'insert_key_value', 'remove_key_value')
- mapping_idstring
The identifier of the mapping being modified
- key_idstring
The identifier of the key in the mapping
- value_idstring
The identifier of the value in the mapping
- aborted_transaction_idsarray
Array of transaction IDs that were aborted in this block