Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

eth_getTransactionReceipt - Story

Example code for the eth_getTransactionReceipt JSON-RPC method. Complete guide on how to use eth_getTransactionReceipt JSON-RPC in GetBlock Web3 documentation.

This method returns the receipt of a mined transaction, including its status, gas used, and emitted logs. It returns null until the transaction is mined.

Parameters

Parameter
Type
Required
Description

transactionHash

string

Yes

32-byte transaction hash

Request

curl --location --request POST 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionReceipt",
    "params": ["0x3c8a1f5b2d9e4076c1a8b3d5e7f9021436587a9cbdef012345678abcdef901234"],
    "id": "getblock.io"
}'
example.js
const axios = require('axios');

const response = await axios.post('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/', {
    jsonrpc: '2.0',
    method: 'eth_getTransactionReceipt',
    params: ['0x3c8a1f5b2d9e4076c1a8b3d5e7f9021436587a9cbdef012345678abcdef901234'],
    id: 'getblock.io'
}, {
    headers: { 'Content-Type': 'application/json' }
});

console.log(response.data.result);
example.py
import requests

response = requests.post(
    'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/',
    headers={'Content-Type': 'application/json'},
    json={
        'jsonrpc': '2.0',
        'method': 'eth_getTransactionReceipt',
        'params': ['0x3c8a1f5b2d9e4076c1a8b3d5e7f9021436587a9cbdef012345678abcdef901234'],
        'id': 'getblock.io'
    }
)

print(response.json())

Response

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": {
        "transactionHash": "0x3c8a1f5b2d9e4076c1a8b3d5e7f9021436587a9cbdef012345678abcdef901234",
        "blockHash": "0x9f2b4c1d7e3a6084b5c9d0e1f2a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d",
        "blockNumber": "0x14b8a10",
        "status": "0x1",
        "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "to": "0x88a5c2d9e0f1b3a4c6d7e8f90a1b2c3d4e5f60718",
        "gasUsed": "0x5208",
        "cumulativeGasUsed": "0x5208",
        "effectiveGasPrice": "0xf4240",
        "logs": []
    }
}

Response Parameters

Parameter
Type
Description

jsonrpc

string

JSON-RPC protocol version ("2.0")

id

string

Request identifier matching the request

result

object

Receipt object, or null if not yet mined (see fields below)

Result Object

Field
Type
Description

status

string

0x1 on success, 0x0 on revert

gasUsed

string

L2 execution gas used by this transaction (hex)

effectiveGasPrice

string

Actual L2 gas price paid (hex, wei)

logs

array

Event logs emitted during execution

Use Cases

  • Success Confirmation: Read status to confirm a transaction succeeded

  • Cost Accounting: Combine gasUsed and effectiveGasPrice to compute the transaction fee

  • Event Extraction: Read logs to capture emitted events

  • Deployment Address: Read contractAddress after a contract creation

Error Handling

Error Code
Message
Description

-32602

Invalid params

Malformed transaction hash

-32603

Internal error

The node failed to read the receipt

Web3 Integration

Was this helpful?