---
title: "Returns the block structure at the specified height"
method: POST
path: "/v1/query/block"
tags: ["query"]
---

# Returns the block structure at the specified height

`POST /v1/query/block`

## Request body

- QueryHeight
  - `height` integer, required

## Response `200`

Returns block structure at the specified height

- QueryBlockResponse
  - `block` Block, required
    - `block_header` BlockHeader, required
      - `height` integer, required
      - `network_id` string, required
      - `state_hash` string, required
      - `prev_state_hash` string, required
      - `proposer_addr` string, required
      - `quorum_cert` QuorumCertificate, required
        - `height` integer, required
        - `round` integer, required
        - `step` string, required
        - `block` string, required
        - `threshold_sig` ThresholdSignature, required
          - `signatures` PartialSignature[], required
            - `signature` string, required
            - `address` string, required
        - `transactions` string[], required
      - `timestamp` string, required
      - `state_tree_hashes` object, required
      - `val_set_hash` string, required
      - `next_val_set_hash` string, required
    - `transactions` IndexedTransaction[], required
      - `height` integer, required
      - `index` integer, required
      - `result_code` integer, required
      - `signer_addr` string, required
      - `recipient_addr` string, required
      - `message_type` string, required
      - `tx` Transaction, required
        - `hash` string, required
        - `height` integer, required
        - `index` integer, required
        - `txMsg` TxMessage, required
          - `fee` Fee, required
            - `amount` string, required
            - `denom` string, required
          - `message` union, required
            - MessageSend
              - …
            - MessageStake
              - …
            - MessageEditStake
              - …
            - MessageUnstake
              - …
            - MessageUnpause
              - …
            - MessageChangeParameter
              - …
          - `nonce` string, required
          - `signature` Signature, required
            - `public_key` string, required
            - `signature` string, required

## Other responses

- `400` — Bad request
- `500` — An error occurred while retrieving the block structure at the specified height

## Changes

- **2026-07-17** (v1) `492a043fd702` — 3 info
  - added the required property `block/block_header/next_val_set_hash` to the response with the `200` status
  - added the required property `block/block_header/state_tree_hashes` to the response with the `200` status
  - added the required property `block/block_header/val_set_hash` to the response with the `200` status
- **2023-05-04** (v1) `ad9f656e884c` — 1 info
  - endpoint added
- **2022-11-03** (v1) `f1547121fa01` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/pokt-network/apis/pocket-network/changes/v1/query/block/post.md)

---

[API](https://skmtc.dev/pokt-network/apis/pocket-network.md) · [All operations](https://skmtc.dev/pokt-network/apis/pocket-network/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pokt-network/pocket-network/revisions/492a043fd702/schema)