---
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

> 9 revisions in range; 1 not diffed.

- **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/tendermint/apis/tendermint-rpc/changes/blockchain/get.md)

---

[API](https://skmtc.dev/tendermint/apis/tendermint-rpc.md) · [All operations](https://skmtc.dev/tendermint/apis/tendermint-rpc/llms.txt) · [OpenAPI document](https://skmtc.dev/tendermint/apis/tendermint-rpc/revisions/ec82847d4988?raw)
