--- title: "GetBlockByHeight queries block for given height." method: GET path: "/cosmos/base/tendermint/v1beta1/blocks/{height}" tags: ["Service"] --- # GetBlockByHeight queries block for given height. `GET /cosmos/base/tendermint/v1beta1/blocks/{height}` ## Path parameters - `height` string, int64, required ## Response `200` A successful response. - CosmosBaseTendermintV1beta1GetBlockByHeightResponse — GetBlockByHeightResponse is the response type for the Query/GetBlockByHeight RPC method. - `block` TendermintTypesBlock - `data` TendermintTypesData - `txs` string[] — Txs that will be applied by state @ block.Height+1. NOTE: not all txs here are valid. We're just agreeing on the order first. This means that block.AppHash does not include these txs. - `evidence` TendermintTypesEvidenceList - `evidence` TendermintTypesEvidence[] - `duplicate_vote_evidence` TendermintTypesDuplicateVoteEvidence — DuplicateVoteEvidence contains evidence of a validator signed two conflicting votes. - `timestamp` string, date-time - `total_voting_power` string, int64 - `validator_power` string, int64 - `vote_a` TendermintTypesVote — Vote represents a prevote or precommit vote from validators for consensus. - `block_id` TendermintTypesBlockID - … - `extension` string, byte — Vote extension provided by the application. Only valid for precommit messages. - `extension_signature` string, byte — Vote extension signature by the validator if they participated in consensus for the associated block. Only valid for precommit messages. - `height` string, int64 - `round` integer - `signature` string, byte — Vote signature by the validator if they participated in consensus for the associated block. - `timestamp` string, date-time - `type` 'SIGNED_MSG_TYPE_UNKNOWN' | 'SIGNED_MSG_TYPE_PREVOTE' | 'SIGNED_MSG_TYPE_PRECOMMIT' | 'SIGNED_MSG_TYPE_PROPOSAL' — SignedMsgType is a type of signed message in the consensus. - SIGNED_MSG_TYPE_PREVOTE: Votes - SIGNED_MSG_TYPE_PROPOSAL: Proposals - `validator_address` string, byte - `validator_index` integer - `vote_b` TendermintTypesVote — Vote represents a prevote or precommit vote from validators for consensus. - `block_id` TendermintTypesBlockID - … - `extension` string, byte — Vote extension provided by the application. Only valid for precommit messages. - `extension_signature` string, byte — Vote extension signature by the validator if they participated in consensus for the associated block. Only valid for precommit messages. - `height` string, int64 - `round` integer - `signature` string, byte — Vote signature by the validator if they participated in consensus for the associated block. - `timestamp` string, date-time - `type` 'SIGNED_MSG_TYPE_UNKNOWN' | 'SIGNED_MSG_TYPE_PREVOTE' | 'SIGNED_MSG_TYPE_PRECOMMIT' | 'SIGNED_MSG_TYPE_PROPOSAL' — SignedMsgType is a type of signed message in the consensus. - SIGNED_MSG_TYPE_PREVOTE: Votes - SIGNED_MSG_TYPE_PROPOSAL: Proposals - `validator_address` string, byte - `validator_index` integer - `light_client_attack_evidence` TendermintTypesLightClientAttackEvidence — LightClientAttackEvidence contains evidence of a set of validators attempting to mislead a light client. - `byzantine_validators` TendermintTypesValidator[] - `address` string, byte - `proposer_priority` string, int64 - `pub_key` TendermintCryptoPublicKey - … - `voting_power` string, int64 - `common_height` string, int64 - `conflicting_block` TendermintTypesLightBlock - `signed_header` TendermintTypesSignedHeader - … - `validator_set` TendermintTypesValidatorSet - … - `timestamp` string, date-time - `total_voting_power` string, int64 - `header` TendermintTypesHeader — Header defines the structure of a block header. - `app_hash` string, byte - `chain_id` string - `consensus_hash` string, byte - `data_hash` string, byte - `evidence_hash` string, byte — evidence included in the block - `height` string, int64 - `last_block_id` TendermintTypesBlockID - `hash` string, byte - `part_set_header` TendermintTypesPartSetHeader - `hash` string, byte - `total` integer - `last_commit_hash` string, byte — commit from validators from the last block - `last_results_hash` string, byte - `next_validators_hash` string, byte - `proposer_address` string, byte - `time` string, date-time - `validators_hash` string, byte — validators for the current block - `version` TendermintVersionConsensus — Consensus captures the consensus rules for processing a block in the blockchain, including all blockchain data structures and the rules of the application's state transition machine. - `app` string, uint64 - `block` string, uint64 - `last_commit` TendermintTypesCommit — Commit contains the evidence that a block was committed by a set of validators. - `block_id` TendermintTypesBlockID - `hash` string, byte - `part_set_header` TendermintTypesPartSetHeader - `hash` string, byte - `total` integer - `height` string, int64 - `round` integer - `signatures` TendermintTypesCommitSig[] - `block_id_flag` 'BLOCK_ID_FLAG_UNKNOWN' | 'BLOCK_ID_FLAG_ABSENT' | 'BLOCK_ID_FLAG_COMMIT' | 'BLOCK_ID_FLAG_NIL' — - BLOCK_ID_FLAG_UNKNOWN: indicates an error condition - BLOCK_ID_FLAG_ABSENT: the vote was not received - BLOCK_ID_FLAG_COMMIT: voted for the block that received the majority - BLOCK_ID_FLAG_NIL: voted for nil - `signature` string, byte - `timestamp` string, date-time - `validator_address` string, byte - `block_id` TendermintTypesBlockID - `hash` string, byte - `part_set_header` TendermintTypesPartSetHeader - `hash` string, byte - `total` integer - `sdk_block` CosmosBaseTendermintV1beta1Block — Block is tendermint type Block, with the Header proposer address field converted to bech32 string. - `data` TendermintTypesData - `txs` string[] — Txs that will be applied by state @ block.Height+1. NOTE: not all txs here are valid. We're just agreeing on the order first. This means that block.AppHash does not include these txs. - `evidence` TendermintTypesEvidenceList - `evidence` TendermintTypesEvidence[] - `duplicate_vote_evidence` TendermintTypesDuplicateVoteEvidence — DuplicateVoteEvidence contains evidence of a validator signed two conflicting votes. - `timestamp` string, date-time - `total_voting_power` string, int64 - `validator_power` string, int64 - `vote_a` TendermintTypesVote — Vote represents a prevote or precommit vote from validators for consensus. - `block_id` TendermintTypesBlockID - … - `extension` string, byte — Vote extension provided by the application. Only valid for precommit messages. - `extension_signature` string, byte — Vote extension signature by the validator if they participated in consensus for the associated block. Only valid for precommit messages. - `height` string, int64 - `round` integer - `signature` string, byte — Vote signature by the validator if they participated in consensus for the associated block. - `timestamp` string, date-time - `type` 'SIGNED_MSG_TYPE_UNKNOWN' | 'SIGNED_MSG_TYPE_PREVOTE' | 'SIGNED_MSG_TYPE_PRECOMMIT' | 'SIGNED_MSG_TYPE_PROPOSAL' — SignedMsgType is a type of signed message in the consensus. - SIGNED_MSG_TYPE_PREVOTE: Votes - SIGNED_MSG_TYPE_PROPOSAL: Proposals - `validator_address` string, byte - `validator_index` integer - `vote_b` TendermintTypesVote — Vote represents a prevote or precommit vote from validators for consensus. - `block_id` TendermintTypesBlockID - … - `extension` string, byte — Vote extension provided by the application. Only valid for precommit messages. - `extension_signature` string, byte — Vote extension signature by the validator if they participated in consensus for the associated block. Only valid for precommit messages. - `height` string, int64 - `round` integer - `signature` string, byte — Vote signature by the validator if they participated in consensus for the associated block. - `timestamp` string, date-time - `type` 'SIGNED_MSG_TYPE_UNKNOWN' | 'SIGNED_MSG_TYPE_PREVOTE' | 'SIGNED_MSG_TYPE_PRECOMMIT' | 'SIGNED_MSG_TYPE_PROPOSAL' — SignedMsgType is a type of signed message in the consensus. - SIGNED_MSG_TYPE_PREVOTE: Votes - SIGNED_MSG_TYPE_PROPOSAL: Proposals - `validator_address` string, byte - `validator_index` integer - `light_client_attack_evidence` TendermintTypesLightClientAttackEvidence — LightClientAttackEvidence contains evidence of a set of validators attempting to mislead a light client. - `byzantine_validators` TendermintTypesValidator[] - `address` string, byte - `proposer_priority` string, int64 - `pub_key` TendermintCryptoPublicKey - … - `voting_power` string, int64 - `common_height` string, int64 - `conflicting_block` TendermintTypesLightBlock - `signed_header` TendermintTypesSignedHeader - … - `validator_set` TendermintTypesValidatorSet - … - `timestamp` string, date-time - `total_voting_power` string, int64 - `header` CosmosBaseTendermintV1beta1Header — Header defines the structure of a Tendermint block header. - `app_hash` string, byte - `chain_id` string - `consensus_hash` string, byte - `data_hash` string, byte - `evidence_hash` string, byte — evidence included in the block - `height` string, int64 - `last_block_id` TendermintTypesBlockID - `hash` string, byte - `part_set_header` TendermintTypesPartSetHeader - `hash` string, byte - `total` integer - `last_commit_hash` string, byte — commit from validators from the last block - `last_results_hash` string, byte - `next_validators_hash` string, byte - `proposer_address` string — proposer_address is the original block proposer address, formatted as a Bech32 string. In Tendermint, this type is `bytes`, but in the SDK, we convert it to a Bech32 string for better UX. original proposer of the block - `time` string, date-time - `validators_hash` string, byte — validators for the current block - `version` TendermintVersionConsensus — Consensus captures the consensus rules for processing a block in the blockchain, including all blockchain data structures and the rules of the application's state transition machine. - `app` string, uint64 - `block` string, uint64 - `last_commit` TendermintTypesCommit — Commit contains the evidence that a block was committed by a set of validators. - `block_id` TendermintTypesBlockID - `hash` string, byte - `part_set_header` TendermintTypesPartSetHeader - `hash` string, byte - `total` integer - `height` string, int64 - `round` integer - `signatures` TendermintTypesCommitSig[] - `block_id_flag` 'BLOCK_ID_FLAG_UNKNOWN' | 'BLOCK_ID_FLAG_ABSENT' | 'BLOCK_ID_FLAG_COMMIT' | 'BLOCK_ID_FLAG_NIL' — - BLOCK_ID_FLAG_UNKNOWN: indicates an error condition - BLOCK_ID_FLAG_ABSENT: the vote was not received - BLOCK_ID_FLAG_COMMIT: voted for the block that received the majority - BLOCK_ID_FLAG_NIL: voted for nil - `signature` string, byte - `timestamp` string, date-time - `validator_address` string, byte ## Other responses - `default` — An unexpected error response. ## Changes - **2025-05-21** `3874a03b0e7b` — 1 info - api operation id `UpgradeService_GetBlockByHeight` removed and replaced with `EvidenceService_GetBlockByHeight` - **2025-05-09** `8dbfaa2bebb2` — 1 info - api operation id `CircuitService_GetBlockByHeight` removed and replaced with `UpgradeService_GetBlockByHeight` - **2025-04-08** `21a675703a05` — 1 info - api operation id `AuthService_GetBlockByHeight` removed and replaced with `CircuitService_GetBlockByHeight` - **2025-03-27** `4f349536c8f3` — 1 info - api operation id `FeegrantService_GetBlockByHeight` removed and replaced with `AuthService_GetBlockByHeight` - **2025-02-24** `2ab9d24288c2` — 1 info - api operation id `CircuitService_GetBlockByHeight` removed and replaced with `FeegrantService_GetBlockByHeight` [Full history](https://skmtc.dev/pokt-network/apis/http-api-console/changes/cosmos/base/tendermint/v1beta1/blocks/:height/get.md) --- [API](https://skmtc.dev/pokt-network/apis/http-api-console.md) · [All operations](https://skmtc.dev/pokt-network/apis/http-api-console/llms.txt) · [OpenAPI document](https://skmtc.dev/pokt-network/apis/http-api-console/revisions/671fab54b729?raw)