---
title: "Search for blocks by FinalizeBlock events"
method: GET
path: "/block_search"
tags: ["Info"]
---

# Search for blocks by FinalizeBlock events

`GET /block_search`

Search for blocks by FinalizeBlock events.

See /subscribe for the query syntax.

## Query parameters

- `query` string, required
- `page` integer
- `per_page` integer
- `order_by` string

## Response `200`

List of paginated blocks matching the search criteria.

- BlockSearchResponse
  - `jsonrpc` string, required
  - `id` integer, required
  - `result` object, required
    - `blocks` BlockComplete[], required
      - `block_id` BlockID
        - `hash` string, required
        - `parts` object, required
          - `total` integer, required
          - `hash` string, required
      - `block` Block
        - `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
              - …
          - `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
        - `data` string[]
        - `evidence` Evidence[]
          - `type` string
          - `height` integer
          - `time` integer
          - `total_voting_power` integer
          - `validator` Validator
            - `pub_key` PubKey
              - …
            - `voting_power` integer
            - `address` string
        - `last_commit` object
          - `height` integer
          - `round` integer
          - `block_id` BlockID
            - `hash` string, required
            - `parts` object, required
              - …
          - `signatures` Commit[]
            - `type` integer, required
            - `height` string, required
            - `round` integer, required
            - `block_id` BlockID, required
              - …
            - `timestamp` string, required
            - `validator_address` string, required
            - `validator_index` integer, required
            - `signature` string, required
    - `total_count` integer, required

## Other responses

- `500` — Error

---

[API](https://skmtc.dev/hetu-project/apis/cometbft-rpc.md) · [All operations](https://skmtc.dev/hetu-project/apis/cometbft-rpc/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hetu-project/cometbft-rpc/revisions/8fdc73beaae2/schema)