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

# Search for blocks by BeginBlock and EndBlock events

`GET /block_search`

Search for blocks by BeginBlock and EndBlock 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.

- BlockResultsResponse
  - `jsonrpc` string, required
  - `id` integer, required
  - `result` object, required
    - `height` string, required
    - `txs_results` object[], nullable
      - `code` string
      - `data` string
      - `log` string
      - `info` string
      - `gas_wanted` string
      - `gas_used` string
      - `events` object[], nullable
        - `type` string
        - `attributes` Event[]
          - `key` string
          - `value` string
          - `index` boolean
      - `codespace` string
    - `begin_block_events` object[], nullable
      - `type` string
      - `attributes` Event[]
        - `key` string
        - `value` string
        - `index` boolean
    - `end_block` object[], nullable
      - `type` string
      - `attributes` Event[]
        - `key` string
        - `value` string
        - `index` boolean
    - `validator_updates` object[], nullable
      - `pub_key` object
        - `type` string, required
        - `value` string, required
      - `power` string
    - `consensus_params_updates` ConsensusParams, nullable
      - `block` object, required
        - `max_bytes` string, required
        - `max_gas` string, required
        - `time_iota_ms` string, required
      - `evidence` object, required
        - `max_age_num_blocks` string, required
        - `max_age_duration` string, required
      - `validator` object, required
        - `pub_key_types` string[], required

## Other responses

- `500` — Error

---

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