Skip to content
Alchemy Logo

eth_getUserOperationByHash

POST
/{apiKey}
CUs20

Return a UserOperation based on a userOpHash.

Limitations

This method retrieves and decodes userOperations from the logs of mined transactions by querying the node. If you attempt to fetch a userOperation from a distant past block, the request may be rejected by the node due to limitations on the block range size it can process.

How far back the lookup scans for the operation's UserOperationEvent depends on the chain and your plan tier. An operation older than the supported range is reported as not found:

ChainFreePay As You GoEnterprise
Arbitrum Mainnet, Arbitrum Sepolia, BNB Smart Chain Mainnet, Base Mainnet, Base Sepolia, Ethereum Mainnet, Ethereum Sepolia, OP Mainnet, OP Sepolia, Polygon PoS Amoy, Polygon PoS Mainnet, Robinhood Chain Mainnet, World Chain Mainnet, World Chain Sepolia150unlimitedunlimited
BNB Smart Chain Testnet505050
Hyperliquid Mainnet1502,0002,000
Monad Mainnet1501,0001,000
Robinhood Chain Testnet1505,0005,000

Chains not listed here support 150 blocks on every tier.

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request

stringformat: "^0x[0-9a-fA-F]*$"required

The userOpHash of the UserOperation to retrieve.

Responses

200

The matched UserOperation with inclusion metadata, or null if no operation is found.

Was this page helpful?