Info

Get block headers (max: 20) for minHeight <= height <= maxHeight.

Get block headers for minHeight <= height <= maxHeight.

At most 20 items will be returned.

Upon success, the Cache-Control header will be set with the default maximum age.

get/blockchain

Query parameters

minHeightinteger

Minimum block height to return

maxHeightinteger

Maximum block height to return

Response

Block headers, returned in descending order (highest first).

idinteger

jsonrpcstring

Example response

{
  "jsonrpc": "2.0",
  "result": {
    "last_height": "1276718",
    "block_metas": [
      {
        "block_id": {
          "hash": "D82C2734BB0E76C772A10994B210EF9D11505D1B98CB189D9CF7F9A5488672A5",
          "parts": {
            "total": 1,
            "hash": "CB02DCAA7FB46BF874052EC2273FD0B1F2CF2E1593298D9781E60FE9C3DB8638"
          }
        },
        "block_size": 1000000,
        "header": {
          "version": {
            "block": "10",
            "app": "0"
          },
          "chain_id": "cosmoshub-2",
          "height": "12",
          "time": "2019-04-22T17:01:51.701356223Z",
          "last_block_id": {
            "hash": "D82C2734BB0E76C772A10994B210EF9D11505D1B98CB189D9CF7F9A5488672A5",
            "parts": {
              "total": 1,
              "hash": "CB02DCAA7FB46BF874052EC2273FD0B1F2CF2E1593298D9781E60FE9C3DB8638"
            }
          },
          "last_commit_hash": "21B9BC845AD2CB2C4193CDD17BFC506F1EBE5A7402E84AD96E64171287A34812",
          "data_hash": "970886F99E77ED0D60DA8FCE0447C2676E59F2F77302B0C4AA10E1D02F18EF73",
          "validators_hash": "D658BFD100CA8025CFD3BECFE86194322731D387286FBD26E059115FD5F2BCA0",
          "next_validators_hash": "D658BFD100CA8025CFD3BECFE86194322731D387286FBD26E059115FD5F2BCA0",
          "consensus_hash": "0F2908883A105C793B74495EB7D6DF2EEA479ED7FC9349206A65CB0F9987A0B8",
          "app_hash": "223BF64D4A01074DC523A80E76B9BBC786C791FB0A1893AC5B14866356FCFD6C",
          "proposer_address": "D540AB022088612AC74B287D076DBFBC4A377A2E"
        },
        "num_txs": "54"
      }
    ]
  }
}

Changes

Changed in 3 of the 18 revisions of this API.426

Jan 22, 20234c3b4d6d6be612See the full diff
- ▲
  removed the required property allOf[subschema #2]/result/block_metas/items/header/voters_hash from the response with the 200 status
  response-required-property-removed
- ○
  added the required property allOf[subschema #2]/result/block_metas/items/header/next_validators_hash to the response with the 200 status
  response-required-property-added
- ○
  added the required property allOf[subschema #2]/result/block_metas/items/header/validators_hash to the response with the 200 status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 5, 2021547cd6bf082921See the full diff
- ▲
  removed the required property allOf[subschema #2]/result/block_metas/items/header/next_validators_hash from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property allOf[subschema #2]/result/block_metas/items/header/validators_hash from the response with the 200 status
  response-required-property-removed
- ○
  added the required property allOf[subschema #2]/result/block_metas/items/header/voters_hash to the response with the 200 status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 15, 2020bf2a6ec6b22d123See the full diff
- ▲
  removed the success response with the status 200
  response-success-status-removed
- ●
  deleted the query request parameter maxHeight
  request-parameter-removed
- ●
  deleted the query request parameter minHeight
  request-parameter-removed
- ○
  api operation id blockchain removed and replaced with
  api-operation-id-removed
- ○
  api tag Info removed
  api-tag-removed
- ○
  removed the non-success response with the status 500
  response-non-success-status-removed

Of the 18 revisions, 1 has no diff computed.

Full history