header_by_hash - Cosmos
Example code for the header_by_hash JSON-RPC method. Complete guide on how to use header_by_hash JSON-RPC in GetBlock Web3 documentation.
Returns a block header by its hash.
Method
header_by_hashParameters
Parameter
Type
Description
hash
string
Block hash
Example
export COSMOS_TM=https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/
# JSON-RPC over HTTP (POST)
curl -X POST "${COSMOS_TM}" -H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": "getblock.io", "method": "header_by_hash", "params": {"hash": "0xA1B2C3..."}}'
# URI over HTTP (GET)
curl "${COSMOS_TM}header_by_hash?hash=0xA1B2C3..."Response
Response Fields
Field
Type
Description
header
object
The block header for the given hash
Use Cases
Hash lookup: Resolve a header when you have its block hash
Error Handling
Error
Message
Description
-32600 / Invalid request
Invalid request
The JSON-RPC envelope was malformed
-32602 / Invalid params
Invalid params
A parameter was missing or of the wrong type
403 / RBAC: access denied
Access denied
The GetBlock access token is missing or incorrect
Was this helpful?