> ## Documentation Index > Fetch the complete documentation index at: https://cosmos-docs-sync-security-docs.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # block_results > Get block results at a specified height Get block_results. If the `height` field is set to a non-default value, upon success, the `Cache-Control` header will be set with the default maximum age. ## OpenAPI ````yaml /cometbft/latest/api-reference/rpc/openapi.yaml get /block_results openapi: 3.0.0 info: title: CometBFT RPC contact: name: CometBFT url: https://docs.cosmos.network/cometbft description: > CometBFT supports the following RPC protocols: * URI over HTTP * JSONRPC over HTTP * JSONRPC over websockets ## Configuration RPC can be configured by tuning parameters under `[rpc]` table in the `$CMTHOME/config/config.toml` file or by using the `--rpc.X` command-line flags. The default RPC listen address is `tcp://127.0.0.1:26657`. To set another address, set the `laddr` config parameter to desired value. CORS (Cross-Origin Resource Sharing) can be enabled by setting `cors_allowed_origins`, `cors_allowed_methods`, `cors_allowed_headers` config parameters. If testing using a local RPC node, under the `[rpc]` section change the `cors_allowed_origins` property, please add the URL of the site where this OpenAPI document is running, for example: `cors_allowed_origins = ["http://localhost:8088"]` or if testing from the official documentation site: `cors_allowed_origins = ["https://docs.cosmos.network"]` ## Arguments Arguments which expect strings or byte arrays may be passed as quoted strings, like `"abc"` or as `0x`-prefixed strings, like `0x616263`. ## URI/HTTP A REST like interface. curl localhost:26657/block?height=5 ## JSONRPC/HTTP JSONRPC requests can be POST'd to the root RPC endpoint via HTTP. curl --header "Content-Type: application/json" --request POST --data '{"method": "block", "params": ["5"], "id": 1}' localhost:26657 ## JSONRPC/websockets JSONRPC requests can be also made via websocket. The websocket endpoint is at `/websocket`, e.g. `localhost:26657/websocket`. Asynchronous RPC functions like event `subscribe` and `unsubscribe` are only available via websockets. For example using the [websocat](https://github.com/vi/websocat) tool, you can subscribe for 'NewBlock` events with the following command: echo '{ "jsonrpc": "2.0","method": "subscribe","id": 0,"params": {"query": "tm.event='"'NewBlock'"'"} }' | websocat -n -t ws://127.0.0.1:26657/websocket version: v0.38.x license: name: Apache 2.0 url: https://github.com/cometbft/cometbft/blob/v0.38.x/LICENSE servers: - url: https://rpc.cosmos.directory/cosmoshub description: Interact with the CometBFT RPC from a public node in the Cosmos registry - url: http://localhost:26657 description: Interact with CometBFT RPC node running locally security: [] tags: - name: Info description: Informations about the node APIs - name: Tx description: Transactions broadcast APIs - name: ABCI description: ABCI APIs - name: Evidence description: Evidence APIs - name: Unsafe description: Unsafe APIs paths: /block_results: get: tags: - Info summary: block_results description: |- Get block results at a specified height Get block_results. If the `height` field is set to a non-default value, upon success, the `Cache-Control` header will be set with the default maximum age. operationId: block_results parameters: - in: query name: height description: >- height to return. If no height is provided, it will fetch information regarding the latest block. schema: type: integer default: 0 example: 1 responses: '200': description: Block results. content: application/json: schema: $ref: '#/components/schemas/BlockResultsResponse' '500': description: Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: BlockResultsResponse: type: object required: - jsonrpc - id - result properties: jsonrpc: type: string example: '2.0' id: type: integer example: 0 result: type: object required: - height properties: height: type: string example: '12' txs_results: type: array nullable: true items: type: object properties: code: type: string example: '0' data: type: string example: '' log: type: string example: not enough gas info: type: string example: '' gas_wanted: type: string example: '100' gas_used: type: string example: '100' events: type: array nullable: true items: type: object properties: type: type: string example: app attributes: type: array nullable: false items: $ref: '#/components/schemas/Event' codespace: type: string example: ibc finalize_block_events: type: array nullable: true items: type: object properties: type: type: string example: app attributes: type: array nullable: false items: $ref: '#/components/schemas/Event' validator_updates: type: array nullable: true items: type: object properties: pub_key: type: object required: - type - value properties: type: type: string example: tendermint/PubKeyEd25519 value: type: string example: 9tK9IT+FPdf2qm+5c2qaxi10sWP+3erWTKgftn2PaQM= power: type: string example: '300' consensus_param_updates: $ref: '#/components/schemas/ConsensusParams' ErrorResponse: description: Error Response allOf: - $ref: '#/components/schemas/JSONRPC' - type: object properties: error: type: string example: Description of failure Event: type: object properties: key: type: string example: action value: type: string example: send index: type: boolean example: false ConsensusParams: type: object nullable: true required: - block - evidence - validator properties: block: type: object required: - max_bytes - max_gas - time_iota_ms properties: max_bytes: type: string example: '22020096' max_gas: type: string example: '1000' time_iota_ms: type: string example: '1000' evidence: type: object required: - max_age properties: max_age: type: string example: '100000' validator: type: object required: - pub_key_types properties: pub_key_types: type: array items: type: string example: - ed25519 JSONRPC: type: object properties: id: type: integer example: 0 jsonrpc: type: string example: '2.0' ````