APIBundlerBundler API Endpoints

eth_getUserOperationReceipt

Get the UserOperationReceipt based on the userOpHash.

Supported EntryPoints

eth_getUserOperationReceipt supports versions v0.6 and v0.7 of ERC-4337. Check our FAQs to determine which version you should use.

Limitations

The eth_getUserOperationReceipt method retrieves and decodes user operations from the logs of mined transactions by querying the node. If you attempt to fetch a receipt for a transaction from a distant past block, the request may be rejected by the node due to limitations on the block range size it can process.

The default range we support is 150 blocks, however the following networks have an unlimited range.

  • Ethereum
  • Polygon
  • Base
  • Optimism
  • Worldchain
  • Arbitrum
Want to get push notifications for mined userOps?

Follow this guide to learn how to use Custom Webhooks and get real time alerts and receipts for mined userOperations.

Path parameters

apiKeystringRequired

Request

This endpoint expects an object.
userOpHashstringRequiredformat: "^0x[0-9a-f]{64}$"

The userOpHash of the UserOperation to get the receipt for (as returned by eth_sendUserOperation).

Response

UserOperationReceipt object representing the outcome of a UserOperation.

userOpHashstring

The request hash of the UserOperation.

entryPointstring

The entrypoint address the request should be sent through. This MUST be one of the entry points returned by the supportedEntryPoints RPC call.

senderstring

The account initiating the UserOperation.

noncestring

The nonce used in the UserOperation.

paymasterstring

The paymaster used for this UserOperation (or empty if self-sponsored).

actualGasCoststring

The actual amount paid (by account or paymaster) for this UserOperation.

actualGasUsedstring

The total gas used by this UserOperation (including preVerification, creation, validation, and execution).

successboolean
Indicates whether the execution completed without reverting.
reasonstring
In case of revert, this is the revert reason.
logslist of strings

The logs generated by this UserOperation (not including logs of other UserOperations in the same bundle).

receiptobject

The TransactionReceipt object for the entire bundle, not only for this UserOperation.