eth_getTransactionReceipt
Last updated:
`eth_getTransactionReceipt` retrieves the receipt produced when a transaction was mined into a block. The receipt is the authoritative record of what actually happened on-chain: whether the transaction succeeded, how much gas it consumed, the logs (events) it emitted, and — when the transaction created a contract — the address of the deployed contract.
Use this method to **confirm a transaction's outcome** after you have submitted it with [eth_sendRawTransaction](./eth_sendRawTransaction.md). A common pattern is to poll this method with the transaction hash until a non-null receipt is returned, then read `status` to determine success or failure.
The method returns `null` when the transaction is still **pending** (not yet mined) or **unknown** (never seen by the node, or dropped from the mempool). A `null` result is not an error — it simply means there is no receipt yet. Note that a non-null receipt does not by itself guarantee finality; for high-value flows, wait for a sufficient number of block confirmations after the receipt appears.
Parameters
This method takes no parameters.
Returns
| Field | Type |
|---|---|
| result | object |
Examples
curl https://<your-endpoint>/ \
-X POST -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_getTransactionReceipt","params":[]}'const res = await fetch("https://<your-endpoint>/", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"id": 1,
"method": "eth_getTransactionReceipt",
"params": [],
"jsonrpc": "2.0"
}),
});
const data = await res.json();import requests
resp = requests.post("https://<your-endpoint>/", json={"id":1,"method":"eth_getTransactionReceipt","params":[],"jsonrpc":"2.0"})
print(resp.json())Usage
- Transport: HTTP (JSON-RPC).
- Networks: mainnet.
- Credit cost: 1 per call.
FAQ
- What does eth_getTransactionReceipt do?
- Returns the receipt of a transaction by its hash — including execution status, gas used, emitted logs, and (for contract deployments) the new contract address.
- How many credits does eth_getTransactionReceipt cost?
- eth_getTransactionReceipt costs 1 credit(s) per call on Triport by default.
- Is eth_getTransactionReceipt available over WebSocket?
- eth_getTransactionReceipt is an HTTP JSON-RPC method.