Get blocks

Get paginated list of blocks

GET /blocks

Query params

Query param	Description
proposer_public_key	Proposer public key

Sorting

Property	Description
block_height	Sort blocks by block height
timestamp	Sort blocks by timestamp

Default sorting is block_height DESC

Optional properties

Property	Type	Description
proposer_account_info	AccountInfo	Account info provided by the block proposer
proposer_centralized_account_info	CentralizedAccountInfo	Account information available for known accounts provided by CSPR.cloud team
proposer_cspr_name	string	Primary CSPR.name of the block proposer account

Response

PaginatedResponse<Block>

Example

curl -X 'GET' \
  'https://api.testnet.cspr.cloud/blocks' \
  -H 'accept: application/json' \
  -H 'authorization: 55f79117-fc4d-4d60-9956-65423f39a06a'

{
  "item_count": 5048237,
  "page_count": 504824,
  "data": [
    {
      "auction_txn_number": 0,
      "block_hash": "c1dde749603911524b24114bf4c59d79bb43f08c94165886c98728c6fbb5a3d4",
      "block_height": 5048236,
      "contract_calls_number": 0,
      "era_id": 18046,
      "gas_price": 1,
      "install_upgrade_txn_number": 0,
      "is_switch_block": false,
      "large_txn_number": 0,
      "medium_txn_number": 0,
      "native_transfers_number": 1,
      "parent_block_hash": "c4b3c15b7038e3bb68a6c155f38b8a44bc3bde3897a427296a000f659f43a7d9",
      "proposer_public_key": "017d96b9a63abcb61c870a4f55187a0a7ac24096bdb5fc585c12a686a4d892009e",
      "small_txn_number": 0,
      "state_root_hash": "30f593517434343a88a7ed8f039aa755367cd66a90f606af0de7e19f1c144ff6",
      "timestamp": "2025-05-26T07:35:27Z",
      "version_id": 1
    },
    {
      "auction_txn_number": 0,
      "block_hash": "c4b3c15b7038e3bb68a6c155f38b8a44bc3bde3897a427296a000f659f43a7d9",
      "block_height": 5048235,
      "contract_calls_number": 0,
      "era_id": 18046,
      "gas_price": 1,
      "install_upgrade_txn_number": 0,
      "is_switch_block": false,
      "large_txn_number": 0,
      "medium_txn_number": 0,
      "native_transfers_number": 1,
      "parent_block_hash": "204a6e71e09bc24a575692906c1a40f0556e07f619dd0dca294fa9797652870f",
      "proposer_public_key": "017d96b9a63abcb61c870a4f55187a0a7ac24096bdb5fc585c12a686a4d892009e",
      "small_txn_number": 0,
      "state_root_hash": "6765672909cb75b1c9d358a77101f329e349156901790d6c65b510d472e58942",
      "timestamp": "2025-05-26T07:35:11Z",
      "version_id": 1
    },
    ...
    {
      "auction_txn_number": 0,
      "block_hash": "e39d93e7d3d6e99d8276a37a450aed2392c2842d581696fd0ea4c4e1ac90bef4",
      "block_height": 5048227,
      "contract_calls_number": 0,
      "era_id": 18046,
      "gas_price": 1,
      "install_upgrade_txn_number": 0,
      "is_switch_block": false,
      "large_txn_number": 0,
      "medium_txn_number": 0,
      "native_transfers_number": 1,
      "parent_block_hash": "136bda9ac5c9f52519e6df1431446e0a04e96b843fed75ef4f5bcf83d1efb6ed",
      "proposer_public_key": "01bfcf41313859cc7246b26307bdc3736ff585beb2165b0879fb9e6535fb0549c3",
      "small_txn_number": 0,
      "state_root_hash": "620df7f266b0b0ae850c15f61f4744844d282ea1ba1ee56783c4c6bd6472d24b",
      "timestamp": "2025-05-26T07:33:00Z",
      "version_id": 1
    }
  ]
}