Info

Search for blocks by BeginBlock and EndBlock events

Search for blocks by BeginBlock and EndBlock events.

See /subscribe for the query syntax.

get/block_search

Query parameters

querystring required
Example:block.height > 1000 AND valset.changed > 0

Query

pageinteger
Example:1

Page number (1-based)

per_pageinteger
Example:30

Number of entries per page (max: 100)

order_bystring
Example:asc

Order in which blocks are sorted ("asc" or "desc"), by height. If empty, default sorting will be still applied.

Response

List of paginated blocks matching the search criteria.

jsonrpcstring required
idinteger required

Example response

{
  "jsonrpc": "2.0",
  "result": {
    "height": "12",
    "txs_results": [
      {
        "code": "0",
        "log": "not enough gas",
        "gas_wanted": "100",
        "gas_used": "100",
        "events": [
          {
            "type": "app",
            "attributes": [
              {
                "key": "YWN0aW9u",
                "value": "c2VuZA=="
              }
            ]
          }
        ],
        "codespace": "ibc"
      }
    ],
    "begin_block_events": [
      {
        "type": "app",
        "attributes": [
          {
            "key": "YWN0aW9u",
            "value": "c2VuZA=="
          }
        ]
      }
    ],
    "end_block": [
      {
        "type": "app",
        "attributes": [
          {
            "key": "YWN0aW9u",
            "value": "c2VuZA=="
          }
        ]
      }
    ],
    "validator_updates": [
      {
        "pub_key": {
          "type": "tendermint/PubKeyEd25519",
          "value": "9tK9IT+FPdf2qm+5c2qaxi10sWP+3erWTKgftn2PaQM="
        },
        "power": "300"
      }
    ],
    "consensus_params_updates": {
      "block": {
        "max_bytes": "22020096",
        "max_gas": "1000",
        "time_iota_ms": "1000"
      },
      "evidence": {
        "max_age_num_blocks": "100000",
        "max_age_duration": "172800000000000"
      },
      "validator": {
        "pub_key_types": [
          "ed25519"
        ]
      }
    }
  }
}

Changes

Changed in 3 of the 18 revisions of this API.24

  • d0517384701613See the full diff
    • the response's body type/format changed from / to object/ for status 200

      response-body-type-changed

    • added the required property id to the response with the 200 status

      response-required-property-added

    • added the required property jsonrpc to the response with the 200 status

      response-required-property-added

    • added the required property result to the response with the 200 status

      response-required-property-added

    • endpoint added

      endpoint-added

    • api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 18 revisions, 1 has no diff computed.