Skip to main content

/v1/blocks/{block_id} REST API Endpoint

Returns block data or list of blocks by providing the block id or the list of IDs.

Updated on
Oct 4, 2023

/v1/blocks/{block_id} REST API Endpoint

Parameters

id
string
REQUIRED
The id of the block
expand
string
A comma-separated list indicating which properties of the content to expand
select
string
A comma-separated list indicating which properties of the content to return

Returns

header
object
The block header which contains the following fields:
id
string
A 32-byte unique identifier for an entity
parent_id
string
The id of the parent block that preceded the current block
height
string
The height of the current block
timestamp
string
The timestamp of when the current block was created
parent_voter_signature
string
The signature of the validator node that voted for the parent block
payload
object
The block payload which contains the following fields:
collection_guarantees
array
It provides additional security and reliability guarantees for collections of transactions or blocks on the Flow blockchain
collection_id
string
A 32-byte unique id of a collection
signer_indices
array
It represents the indices of the accounts that signed the collection
signature
string
A cryptographic signature of the collection guarantees
block_seals
array
It refers to the cryptographic signatures and approvals that validate and secure a specific block of transactions
block_id
string
The unique id of the block that the block seals are associated with
result_id
string
The unique id of the result
final_state
string
The root hash of the state tree
aggregated_approval_signatures
array
It refers to the combined cryptographic signatures of multiple nodes that approved a specific block of transactions
verifier_signatures
array
The cryptographic signatures of the nodes that acted as verifiers for the block
signer_ids
array
The list of signer ids
execution_result
object
The execution result object which contains the following fields:
id
string
The unique id of the execution result
block_id
string
The unique id of the block that contains the transactions that generated the execution result
events
array
An array of events that were emitted during the execution of the transactions. It contains the following fields:
type
string
The type of the event, which is typically a string that identifies the purpose or function of the event
transaction_id
string
The unique id of the transaction that emitted the event
transaction_index
string
The index of the transaction that emitted the event
event_index
string
The index of the event within the transaction
payload
string
The data payload associated with the event, which can be used to provide additional information about the event
chunks
array
An array of data chunks generated during the execution of the transaction. It contains the following fields:
collection_index
string
The index of the collection that the chunk belongs to
start_state
string
The state of the blockchain before the execution of the chunk
event_collection
string
The collection of events that were emitted during the execution of the chunk
block_id
string
The ID of the block that the chunk belongs to
total_computation_used
string
The total amount of computation resources that were consumed during the execution of the chunk
number_of_transactions
string
The number of transactions that were included in the chunk
index
string
The index of the chunk within the block
end_state
string
The state of the blockchain after the execution of the chunk
previous_result_id
string
The unique id of the previous execution result
_links
object
An object that contains links to related resources or endpoints
_self
string
It is a link that refers to the current resource itself. In this case, it is the block resource requested
_expandable
object
The items inside the _expandable object can be expanded by passing as the query parameter in the request. For this method, the parameters payload and execution_result have been added to the request
_links
object
An object that contains links to related resources or endpoints
_self
string
It is a link that refers to the current resource itself. In this case, it is the block resource requested
Request
1
curl -X 'GET' 'https://docs-demo.flow-mainnet.quiknode.pro/v1/blocks/331bea8eb3d9f8913c615f64750bc26bf2b5cb16eb4639e4495c0cebeae30173?expand=payload,execution_result' \
2
-H 'Content-Type: application/json'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free