---
title: "Get block headers (max: 20) for minHeight <= height <= maxHeight."
method: GET
path: "/blockchain"
tags: ["Info"]
---

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

`GET /blockchain`

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.

## Query parameters

- `minHeight` integer
- `maxHeight` integer

## Response `200`

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

- BlockchainResponse — Blockchain info
  - `id` integer
  - `jsonrpc` string
  - `result` Blockchain
    - `last_height` string, required
    - `block_metas` BlockMeta[], required
      - `block_id` BlockID
        - `hash` string, required
        - `parts` object, required
          - `total` integer, required
          - `hash` string, required
      - `block_size` integer
      - `header` BlockHeader
        - `version` object, required
          - `block` string, required
          - `app` string, required
        - `chain_id` string, required
        - `height` string, required
        - `time` string, required
        - `last_block_id` BlockID, required
          - `hash` string, required
          - `parts` object, required
            - `total` integer, required
            - `hash` string, required
        - `last_commit_hash` string, required
        - `data_hash` string, required
        - `validators_hash` string, required
        - `next_validators_hash` string, required
        - `consensus_hash` string, required
        - `app_hash` string, required
        - `last_results_hash` string, required
        - `evidence_hash` string, required
        - `proposer_address` string, required
      - `num_txs` string

## Other responses

- `500` — Error

## Changes

> 18 revisions in range; 1 not diffed.

- **2023-01-22** `4c3b4d6d6be6` — 1 breaking, 2 info
  - removed the required property `allOf[subschema #2]/result/block_metas/items/header/voters_hash` from the response with the `200` status
  - added the required property `allOf[subschema #2]/result/block_metas/items/header/next_validators_hash` to the response with the `200` status
  - added the required property `allOf[subschema #2]/result/block_metas/items/header/validators_hash` to the response with the `200` status
- **2021-07-05** `547cd6bf0829` — 2 breaking, 1 info
  - removed the required property `allOf[subschema #2]/result/block_metas/items/header/next_validators_hash` from the response with the `200` status
  - removed the required property `allOf[subschema #2]/result/block_metas/items/header/validators_hash` from the response with the `200` status
  - added the required property `allOf[subschema #2]/result/block_metas/items/header/voters_hash` to the response with the `200` status
- **2020-09-15** `bf2a6ec6b22d` — 1 breaking, 2 warning, 3 info
  - removed the success response with the status `200`
  - deleted the `query` request parameter `maxHeight`
  - deleted the `query` request parameter `minHeight`
  - api operation id `blockchain` removed and replaced with ``
  - …2 more

[Change history](https://skmtc.dev/finschia/apis/ostracon-rpc/changes/blockchain/get.md)

---

[API](https://skmtc.dev/finschia/apis/ostracon-rpc.md) · [All operations](https://skmtc.dev/finschia/apis/ostracon-rpc/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finschia/ostracon-rpc/revisions/f8b90bf02ef4/schema)