---
title: "Block headers by ID"
method: GET
path: "/blocks/headers/{id}"
tags: ["blocks"]
---

# Block headers by ID

`GET /blocks/headers/{id}`

Get headers of a given block

## Path parameters

- `id` union, required
  - string
  - string

## Response `200`

successful operation

- BlockHeader
  - `timestamp` integer, required
  - `version` integer, required
  - `height` integer, required
  - `totalFee` integer, required
  - `reference` string, required
  - `generator` string, required
  - `generatorPublicKey` string, required
  - `signature` string, required
  - `id` string
  - `nxt-consensus` object, required
    - `base-target` integer, required
    - `generation-signature` string, required
  - `blocksize` integer, required
  - `transactionCount` integer, required
  - `features` integer[]
  - `reward` integer
  - `rewardShares` object — map of address <-> reward
  - `desiredReward` integer
  - `VRF` string, required
  - `transactionsRoot` string, required
  - `stateHash` string
  - `finalizationVoting` union
    - object
      - `valid` GeneratorIndex[], required
      - `finalizedHeight` integer, required
      - `aggregatedEndorsement` string, required
      - `conflict` BlockEndorsement[], required
        - `endorserIndex` integer, required
        - `finalizedId` union, required
          - string
          - string
        - `finalizedHeight` integer, required
        - `endorsedId` union, required
          - string
          - string
        - `signature` string, required
    - object
      - `valid` GeneratorIndex[], required
      - `finalizedHeight` integer, required
      - `aggregatedEndorsement` string, required
      - `conflict` BlockEndorsement[]
        - `endorserIndex` integer, required
        - `finalizedId` union, required
          - string
          - string
        - `finalizedHeight` integer, required
        - `endorsedId` union, required
          - string
          - string
        - `signature` string, required
    - object
      - `valid` GeneratorIndex[]
      - `finalizedHeight` integer, required
      - `aggregatedEndorsement` string
      - `conflict` BlockEndorsement[], required
        - `endorserIndex` integer, required
        - `finalizedId` union, required
          - string
          - string
        - `finalizedHeight` integer, required
        - `endorsedId` union, required
          - string
          - string
        - `signature` string, required

## Changes

- **2026-03-31** `d9769537f2c3` — 1 info
  - added the optional property `finalizationVoting` to the response with the `200` status
- **2023-11-09** `55abcf4c27fb` — 1 info
  - added the optional property `stateHash` to the response with the `200` status
- **2023-10-13** `6d61389e0fa7` — 1 warning
  - removed the optional property `stateHash` from the response with the `200` status
- **2023-08-07** `7625bbb16b0e` — 1 info
  - added the optional property `stateHash` to the response with the `200` status
- **2023-06-07** `20422bf4ff5a` — 1 warning, 1 info
  - removed the optional property `stateHash` from the response with the `200` status
  - added the optional property `rewardShares` to the response with the `200` status

[Full history](https://skmtc.dev/wavesplatform/apis/waves-full-node-chainid/changes/blocks/headers/:id/get.md)

---

[API](https://skmtc.dev/wavesplatform/apis/waves-full-node-chainid.md) · [All operations](https://skmtc.dev/wavesplatform/apis/waves-full-node-chainid/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wavesplatform/waves-full-node-chainid/revisions/09465bcdf6ce/schema)