eth_getTransactionByHash

A transaction hash is the canonical handle for any payment or contract call on BNB Smart Chain, and eth_getTransactionByHash turns that handle back into the full object: sender, recipient, BNB value, gas fields, input calldata, signature, and the block it landed in. The hash is the same value bscscan.com shows on its explorer pages, so you can copy one straight across. Point the query at https://bsc.therpc.io/YOUR_API_KEY on chain ID 56; a still-pending or unknown transaction comes back with null block fields or null outright, which is how you tell mined from unmined.

Use cases

• Check that a transaction you broadcast actually made it into a BSC block by testing whether blockNumber is no longer null.
• Decode the input calldata against an ABI to discover which contract function the transaction invoked and with what arguments.
• Pull the from address and BNB value to verify an incoming payment matches what your application expected.

Parameters

Response

Example request

1curl https://bsc.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "eth_getTransactionByHash",
7    "params": ["0x0000000000000000000000000000000000000000000000000000000000000000"],
8    "id": 1
9  }'

Try it live in the BNB Smart Chain playground.

Errors & troubleshooting

Common pitfalls

• Getting an object back proves only that the transaction exists, not that it succeeded. Fetch the receipt and read its status field to learn whether execution reverted.
• A transaction still sitting in the mempool comes back populated but with blockHash, blockNumber, and transactionIndex all set to null.
• Dropped or never-broadcast hashes resolve to null, so always null-check the response before you reach into its fields.

Supported networks

• Mainnet — Chain ID: 56
• Testnet — Chain ID: 97

See also

• eth_getTransactionReceipt
• eth_getTransactionByBlockHashAndIndex
• eth_getTransactionByBlockNumberAndIndex

1curl https://bsc.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getTransactionByHash","params":[""]}'