eth_getBlockReceipts - IoTeX RPC Method
Return every transaction receipt in a block on IoTeX. Useful for indexers, analytics pipelines, and event backfills across decentralized physical infrastructure (DePIN), IoT device identity (ioID), and AI-verified real-world data.
Returns all transaction receipts for a block on IoTeX. This is more efficient than calling eth_getTransactionReceipt once per transaction when you already know the target block.
Why IoTeX? Build on the leading DePIN infrastructure blockchain powering 130+ applications in the $27B+ DePIN ecosystem with W3bstream offchain compute, Quicksilver AI data verification, Vodafone partnership for 5M+ cell tower integration, and ioID device identity.
When to Use This Method
eth_getBlockReceipts is useful for DePIN builders, IoT device manufacturers, and real-world AI application developers:
- Indexer Backfills — Pull every receipt in a block with one request instead of looping over transaction hashes
- Event Collection — Scan all logs emitted by a block when building analytics or data pipelines
- Settlement Auditing — Verify every transaction outcome in a target block for decentralized physical infrastructure (DePIN), IoT device identity (ioID), and AI-verified real-world data
- Operational Debugging — Compare receipt-level gas usage, status, and logs across multiple transactions at once
Request Parameters
Block number, block tag such as latest, or 32-byte block hash
Response Body
Array of receipt objects for the block, or null if the block is not found
Transaction hash
0x1 on success, 0x0 on failure
Gas used by this transaction
Total gas used in the block up to this transaction
Logs emitted by the transaction
Created contract address for deployment transactions
Effective gas price paid by the sender
Code Examples
curl -X POST https://api-iotex-mainnet.n.dwellir.com/YOUR_API_KEY \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBlockReceipts",
"params": ["0xc5bd9f787bec85feee50f013caebb999107e5ba47da16ac194a5dbb06b5f4ff2"],
"id": 1
}'Error Handling
| Error Code | Message | Description |
|---|---|---|
| -32602 | Invalid params | The block identifier is malformed |
| -32000 | Header not found | The referenced block does not exist on the node |
Related Methods
eth_getTransactionReceipt- Retrieve a single transaction receipteth_getBlockByHash- Retrieve the block object itselfeth_getBlockByNumber- Retrieve a block by number or tag
eth_getBlockByHash
Retrieve complete block data by block hash on IoTeX. Essential for DePIN builders, IoT device manufacturers, and real-world AI application developers building on the leading DePIN infrastructure blockchain powering 130+ applications in the $27B+ DePIN ecosystem.
eth_getBalance
Query account balance on IoTeX. Essential for wallet applications and decentralized physical infrastructure (DePIN), IoT device identity (ioID), and AI-verified real-world data on the leading DePIN infrastructure blockchain powering 130+ applications in the $27B+ DePIN ecosystem.