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 04, 2023

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

array
array

An array of block objects for the requested block ID or IDs

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
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free