eth_getBlockReceipts

Returns the receipts of a block by number or hash.

Ethereum specification · All supported methods

Parameters

Parameters are positional, in the order below.

Parameter	Type	Required	Description
Block	Block number, tag, or EIP-1898 hash selector	Yes	Block reference for the request.

Return value

An array of receipt objects for the block, or null if the block is not found.

Each returned item includes these fields:

Field	Type	Description
type	Hexadecimal quantity	Transaction type as a hexadecimal quantity.
transactionHash	32-byte hash	Hash of the transaction.
transactionIndex	Hexadecimal quantity	Position of the transaction within its block.
blockHash	32-byte hash	Hash of the containing block; null for a pending transaction.
blockNumber	Hexadecimal quantity	Number of the containing block; null for a pending transaction.
from	20-byte address	Sender address.
to	20-byte address or null	Address of the receiver or null in a contract creation transaction.
cumulativeGasUsed	Hexadecimal quantity	The sum of gas used by this transaction and all preceding transactions in the same block.
gasUsed	Hexadecimal quantity	The amount of gas used for this specific transaction alone.
blobGasUsed	Hexadecimal quantity	The amount of blob gas used for this specific transaction. Only specified for blob transactions as defined by EIP-4844.
contractAddress	20-byte address or null	The contract address created, if the transaction was a contract creation, otherwise null.
logs	Array of log objects	Event logs emitted by the transaction.
logsBloom	256-byte bloom filter	Bloom filter summarizing log addresses and topics.
root	32-byte hash	The post-transaction state root. Only specified for transactions included before the Byzantium upgrade.
status	Hexadecimal quantity	Either 1 (success) or 0 (failure). Only specified for transactions included after the Byzantium upgrade.
effectiveGasPrice	Hexadecimal quantity	The actual value per gas deducted from the sender's account. Before EIP-1559, this is equal to the transaction's gas price. After, it is equal to baseFeePerGas + min(maxFeePerGas - baseFeePerGas, maxPriorityFeePerGas).
blobGasPrice	Hexadecimal quantity	The actual value per gas deducted from the sender's account for blob gas. Only specified for blob transactions as defined by EIP-4844.

Example

Replace <gateway-url> with your gateway base URL and <service-url> with the chain’s service path, such as service/ethereum.

curl -X POST "<gateway-url>/<service-url>" \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","id":1,"method":"eth_getBlockReceipts","params":["latest"]}'

Illustrative response; values depend on the selected network and request:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "blockHash": "0x19514ce955c65e4dd2cd41f435a75a46a08535b8fc16bc660f8092b32590b182",
      "blockNumber": "0x6f55",
      "contractAddress": null,
      "cumulativeGasUsed": "0x18c36",
      "from": "0x22896bfc68814bfd855b1a167255ee497006e730",
      "gasUsed": "0x18c36",
      "blobGasUsed": "0x20000",
      "effectiveGasPrice": "0x9502f907",
      "blobGasPrice": "0x32",
      "logs": [
        {
          "address": "0xfd584430cafa2f451b4e2ebcf3986a21fff04350",
          "topics": [
            "0x2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d",
            "0x4be29e0e4eb91f98f709d98803cba271592782e293b84a625e025cbb40197ba8",
            "0x000000000000000000000000835281a2563db4ebf1b626172e085dc406bfc7d2",
            "0x00000000000000000000000022896bfc68814bfd855b1a167255ee497006e730"
          ],
          "data": "0x",
          "blockNumber": "0x6f55",
          "transactionHash": "0x4a481e4649da999d92db0585c36cba94c18a33747e95dc235330e6c737c6f975",
          "transactionIndex": "0x0",
          "blockHash": "0x19514ce955c65e4dd2cd41f435a75a46a08535b8fc16bc660f8092b32590b182",
          "logIndex": "0x0",
          "removed": false
        }
      ],
      "logsBloom": "0x00000004000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000080020000000000000200010000000000000000000001000000800000000000000000000000000000000000000000000000000000100100000000000000000000008000000000000000000000000000000002000000000000000000000",
      "status": "0x1",
      "to": "0xfd584430cafa2f451b4e2ebcf3986a21fff04350",
      "transactionHash": "0x4a481e4649da999d92db0585c36cba94c18a33747e95dc235330e6c737c6f975",
      "transactionIndex": "0x0",
      "type": "0x0"
    },
    {
      "blockHash": "0x19514ce955c65e4dd2cd41f435a75a46a08535b8fc16bc660f8092b32590b182",
      "blockNumber": "0x6f55",
      "contractAddress": null,
      "cumulativeGasUsed": "0x1de3e",
      "from": "0x712e3a792c974b3e3dbe41229ad4290791c75a82",
      "gasUsed": "0x5208",
      "blobGasUsed": "0x20000",
      "effectiveGasPrice": "0x9502f907",
      "blobGasPrice": "0x32",
      "logs": [],
      "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "status": "0x1",
      "to": "0xd42e2b1c14d02f1df5369a9827cb8e6f3f75f338",
      "transactionHash": "0xefb83b4e3f1c317e8da0f8e2fbb2fe964f34ee184466032aeecac79f20eacaf6",
      "transactionIndex": "0x1",
      "type": "0x2"
    }
  ]
}

Direct behavior

Requests for older chain data are automatically routed to providers with full chain history. This covers blocks, transactions, receipts, and logs independently of historical account state.

Requests using latest follow Direct’s reference-block rules. The selected reference is preserved during recovery; separate requests can see a newer reference.

Limits

The shared limits cover the complete receipt list for the block. Internal assembly does not create a separate allowance for each receipt. Incomplete or oversized results return an error.

For providers

Support the required recent chain-history service. Advertise full chain history only when all included method families and lookup indexes work back to genesis.

This method is checked independently as an optional method capability. Failure does not disqualify ordinary RPC service. Historical coverage is checked in combination with the relevant history capability.

See provider qualification for checks and continued eligibility.