subscan-stg
  1. block
subscan-stg
  • Introduction
  • Tutorial
  • Global Conventions
  • Changelog
  • Subscan API Pro
  • search
    • Check hash type and retrieve associated data
      POST
  • common
    • Get current server timestamp
      GET
  • parachain
    • Account crowdloan contributions
      POST
    • Parachain info
      POST
    • Auction competitors
      POST
    • Get parachain list
      POST
    • Auction funds stat
      POST
    • Parachain meta
      POST
    • Auction leading blocks
      POST
    • Parachain register info
      POST
    • PLO auctions list
      POST
    • Best bid
      POST
    • PLO slot bids list
      POST
    • Crowdloan fund contributes list
      POST
    • Crowdloan fund stat
      POST
    • Crowdloan funds list
      POST
    • Winner predict
      POST
  • governance
    • Account referendum list
    • Child Bounty list
    • Bounty info
    • Bounty list
    • Council proposal
    • Council proposals
    • Democracy details
    • Democracies list
    • Referendum list(legacy)
    • Referendums
    • Democracy seconded list
    • Referendum votes list(legacy)
    • Fellowship referenda details
    • Fellowship referenda list
    • Fellowship referendum statistics
    • Fellowship referendum tracks
    • Fellowship referendum statistics
    • Fellowship referendum tracks
    • Fellowship referendum votes
    • more information about the governance
    • Preimage details
    • Preimage list
    • Referendum statistics
    • Referendum delegator details
    • Referendum tracks
    • Referendum delegator votes
    • Referendum delegated of delegator list
    • Referenda details
    • Referenda list
    • Referendum statistics
    • Referendum tracks
    • Referenda votes list(v2)
    • Techcomm proposal
    • Techcomm proposals
    • Get treasury proposal details
    • Get treasury proposals list
    • Treasury tip
    • Treasury tippers
    • Treasury tips
    • treasury council collective details
    • treasury council collective list
    • treasury council collective vote list
    • Treasury spend proposal
    • Get treasury spend proposals list
  • staking
    • Get reward and slash event list
    • Get daily aggregated reward/slash data
    • Get era statistics for a validator
    • Get nominator information
    • Get nominators list for a validator
    • Get total staking rewards
    • Get unbonding list
    • Get validator information
    • Get validator bond statistics
    • Get validator commission history
    • Get active validators list
    • Get nominated validators list
    • Get waiting validators list
    • Staking reward sum
    • Get account reward and slash list (V2)
  • account
    • Get account assets change history
    • Get account balance history
    • Get account token list
    • Get account merkle list
    • Get account statistics
    • Search accounts by identity
    • Get token holders list
    • Account token list v2
    • Get accounts list
    • Account by address
    • Transfers list
  • assets
    • Asset account balances
    • Asset activities
    • Assets list all
    • Asset info
    • Asset holders
    • Assets list all
    • Assets list
    • Asset transfers
  • block
    • Get block details
      POST
    • Block header
      POST
    • Get block header
      POST
    • Get blocks list
      POST
  • collator
    • Collator Info
    • Collator List
    • Collator Meta
    • Collator Timelime
  • contracts
    • Get contract events
    • Get contract information
    • Get WASM contract list
    • Get contract metadata statistics
    • Get contract lifetime timeline
    • Get WASM contract transactions
    • Compiler images tag
    • Get available compiler versions
    • Verify wasm contract log
  • stat
    • Daily stat
    • Get monthly active users statistics
    • Get daily token statistics
    • Get token price history
    • Daily stat(v2)
  • api
    • Download progress
    • Get current network metadata
  • event
    • Get event details by index
    • Get event parameters in batch
    • Events list
  • EVM
    • ABI by method id or event topic
    • EVM account tokens
    • Evm block by block number
    • EVM Blocks
    • EVM contract detail
    • EVM contract list
    • Polkadot pvm resolc versions
    • EVM erc1155 collectible detail
    • EVM erc1155 token holders
    • EVM ERC1155 collectibles
    • EVM erc721 collectible detail
    • EVM ERC721 collectibles
    • EVM event Logs
    • Etherscan-like API
    • Evm meta
    • EVM erc20/erc721/erc1155 token
    • EVM token holders
    • EVM token transfer
    • EVM erc20/erc721/erc1155 tokens
    • EVM transaction info
    • EVM internal Tx
    • Evm transactions
  • extrinsic
    • Get extrinsic details
    • Get extrinsic parameters in batch
    • Get extrinsic reward list
    • Get raw extrinsic data
    • Get pending extrinsics
    • Extrinsics list
  • log
    • Get block log by index
    • Logs list
    • Block log list
  • multiChain
    • MultiChain account (BETA)
    • Get multi-chain account count (BETA)
    • Account balance value history (BETA)
    • Account balance value stat (BETA)
    • MultiChain price (BETA)
    • MultiChain account (BETA)
    • MultiChain identities
  • enjin
    • Enjin multiToken holder balance
    • Enjin multiToken activities
    • Enjin multiToken holders
    • Enjin multiToken collection all
    • Enjin multiToken info
    • Enjin multiToken item detail
    • Enjin multiToken item all
    • Enjin multiToken list
  • multisig
    • Get multisig extrinsic details
    • Multisig extrinsic list
    • Get multisig extrinsic details list
  • NFTs
    • NFT account balances
    • NFT activities
    • NFT info
    • NFT holders
    • NFT item
    • NFT items
    • NFTs list
  • nominationPools
    • Nomination Pools Activities
    • Nomination Pools Info
    • Nomination Pools Member Vote
    • Nomination Pools Members
    • Nomination Pools List
    • Nomination Pools Rewards
  • currency
    • supported currencies
    • supported currencies
    • currency price
    • currency price
    • currency price converter
    • currency price converter
  • proxy
    • Get proxy extrinsics list
  • runtime
    • Get runtime version list
    • Get runtime metadata
    • Get runtime module list
  • crustStorage
    • Crust storage daily stat
    • Crust storage group detail
    • Crust storage group members
    • Crust storage groups
    • Crust storage group member detail
    • Crust storage group member files
    • Crust storage group member orders
    • Crust storage orders
  • token
    • Get network token list (by symbol)
    • Get current token prices
    • Get network token list (by unique ID)
  • uniques
    • Uniques holders item balances
    • Uniques activities
    • Uniques list all
    • Uniques info
    • Uniques holders
    • Uniques item info
    • Uniques items
    • Uniques list
  • vesting
    • Vesting release list
  • tokens
    • Native token list
    • Tokens providers
    • Tokens search
    • Tokens(v2)
  • health
    • Health check endpoint
    • Readiness check endpoint
  • accounts
    • Resource count
  • uniqueNetwork
    • NFT account balances
    • NFT activities
    • NFT info
    • NFT holders
    • NFT item
    • NFT items
    • NFTs list
  • coretime
    • Coretime assign list
    • Coretime Event list
    • Coretime Region Purchased list
    • Coretime region info
    • Coretime Region list
    • Coretime sale info
    • Coretime sale history list
    • Coretime workload details
    • Coretime workload history
    • Coretime workload list
    • Coretime workplan list
  • Avail
    • Submitted Data info
    • Submitted Data list
  • foreignAssets
    • ForeignAssets account balances
    • ForeignAssets activities
    • ForeignAssets list all
    • ForeignAssets list all
    • ForeignAssets info
    • ForeignAssets holders
    • ForeignAssets list
  • ibc
    • Ibc Transfers list
  • moonbeam
    • Get Moonbeam Orbiters rewards
  • Xcm
    • Xcm Bridge Stat (PRO)
    • Xcm Channel (PRO)
    • Xcm Channels (PRO)
    • Find Xcm message id by hash (PRO)
    • Xcm Message detail (PRO)
    • Get XCM message list (PRO API)
    • Xcm Meta (PRO)
    • Xcm Stat (PRO)
    • Xcm Sender Stat (PRO)
  • bifrost
    • LiquidStaking operation record list
  • scheduler
    • Get scheduler task details
    • Get scheduler task list
    • Get scheduler statistics
  • sxt
    • sxt evm holder list
    • sxt evm transfer list
  1. block

Get blocks list

Polkadot
https://polkadot.api.subscan.io
Polkadot
https://polkadot.api.subscan.io
POST
/api/v2/scan/blocks
Retrieve a paginated list of blocks with basic information including block number, hash, timestamp, validator, and counts of extrinsics and events. Supports filtering by validator and block range.

Request

Header Params

Body Params application/jsonRequired

Example
{
    "after_id": 0,
    "author": "string",
    "block_range": "string",
    "page": 0,
    "row": 10
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://polkadot.api.subscan.io/api/v2/scan/blocks' \
--header 'x-api-key: 4d0c8ba32dde4a06bda83d52af49120f' \
--header 'Content-Type: application/json' \
--data-raw '{
    "after_id": 0,
    "author": "string",
    "block_range": "string",
    "page": 0,
    "row": 10
}'

Responses

🟢200OK
application/json
Successfully retrieved blocks list with pagination
Body

Example
{
    "code": 0,
    "data": {
        "blocks": [
            {
                "account_display": {
                    "account_index": "string",
                    "address": "string",
                    "display": "string",
                    "evm_address": "string",
                    "evm_contract": {
                        "contract_name": "string",
                        "verify_source": "string"
                    },
                    "identity": true,
                    "judgements": [
                        {
                            "index": 0,
                            "judgement": "string"
                        }
                    ],
                    "merkle": {
                        "address_type": "string",
                        "tag_name": "string",
                        "tag_subtype": "string",
                        "tag_type": "string"
                    },
                    "parent": {
                        "address": "string",
                        "display": "string",
                        "identity": true,
                        "sub_symbol": "string"
                    },
                    "people": {
                        "display": "string",
                        "identity": true,
                        "judgements": [
                            {
                                "index": 0,
                                "judgement": "string"
                            }
                        ],
                        "parent": {
                            "address": "string",
                            "display": "string",
                            "identity": true,
                            "sub_symbol": "string"
                        }
                    }
                },
                "additional_meta": {},
                "block_num": 0,
                "block_timestamp": 0,
                "event_count": 0,
                "extrinsics_count": 0,
                "finalized": true,
                "hash": "string",
                "max_proof_size": 0,
                "max_ref_time": 0,
                "proof_size": 0,
                "ref_time": 0
            }
        ],
        "count": 0
    },
    "generated_at": 1699600641,
    "message": "Success"
}
Modified at 2025-11-18 09:27:21
Previous
Get block header
Next
Collator Info
Built with