v1
latestOpenAPI 3.0.02026-07-26268286602.5 KBblocks
List blocks with optional filtering by block type
Retrieves a paginated list of blocks ordered by descending block number.
When the type query parameter is omitted, only main-chain consensus blocks (equivalent to type=block) are returned. Use type=uncle to list ommer blocks (valid but not in the main chain) and type=reorg to list blocks that lost consensus during a chain reorganization.
Pagination is cursor-based: the response contains next_page_params with block_number — pass these back as query parameters on the next request to fetch the following page.
get/{chain_id}/api/v2/blocks
Path parameters
chain_idstring required
The ID of the blockchain
Query parameters
type'uncle' | 'reorg' | 'block'
Filter by block type:
- block - Standard blocks in the main chain
- uncle - Uncle/ommer blocks (valid but not in main chain)
- reorg - Blocks from chain reorganizations If omitted, default value "block" is used.
items_countinteger
Number of items per page
block_numberinteger
Block number for paging
Response
List of blocks with pagination information.
Example response
{
"next_page_params": {
"block_number": 22566361
}
}