Docs
Supported ChainsPolygonJSON-RPC APIBlock Methods

eth_getBlockReceipts - Polygon RPC Method

Return every transaction receipt in a block on Polygon. Useful for indexers, analytics pipelines, and event backfills across enterprise solutions (Starbucks, Disney, Reddit), gaming, DeFi, and stablecoin payments.

Returns all transaction receipts for a block on Polygon. This is more efficient than calling eth_getTransactionReceipt once per transaction when you already know the target block.

Why Polygon? Build on the most adopted Ethereum scaling solution with 45,000+ dApps and enterprise partnerships with $4B+ TVL, sub-$0.01 transactions, 8M+ daily transactions, and zkEVM for enhanced security.

When to Use This Method

eth_getBlockReceipts is useful for enterprise developers, gaming studios, and teams building high-throughput applications:

  • 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 enterprise solutions (Starbucks, Disney, Reddit), gaming, DeFi, and stablecoin payments
  • Operational Debugging — Compare receipt-level gas usage, status, and logs across multiple transactions at once

Request Parameters

Request
blockQUANTITY | TAG | DATA

Block number, block tag such as latest, or 32-byte block hash

Response Body

Response
resultArray<Object> | null

Array of receipt objects for the block, or null if the block is not found

transactionHashDATA

Transaction hash

statusQUANTITY

0x1 on success, 0x0 on failure

gasUsedQUANTITY

Gas used by this transaction

cumulativeGasUsedQUANTITY

Total gas used in the block up to this transaction

logsArray<Object>

Logs emitted by the transaction

contractAddressDATA | null

Created contract address for deployment transactions

effectiveGasPriceQUANTITY

Effective gas price paid by the sender

Code Examples

Bash
curl -X POST https://api-polygon-mainnet-full.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockReceipts",
    "params": ["0xf3425ff44ecaa4066e2f88ea1873e8c7adeb21db3765b9af80a577b35b5eed32"],
    "id": 1
  }'

Error Handling

Error CodeMessageDescription
-32602Invalid paramsThe block identifier is malformed
-32000Header not foundThe referenced block does not exist on the node