{"uid":"cap_41frXWFLlE_lDqsvBUYCG","slug":"transaction-status-revert-reason-1e5f2ead","name":"Transaction Status & Revert Reason","description":"What happened to my transaction? Status, block, gas used, fee paid - and if it failed, the revert reason in plain text, recovered by replaying the call against its block. The receipt alone does not carry that reason.","url":"https://api.eucompliance.tools/x402/tx","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["tx_hash"],"properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string"},"tx_hash":{"type":"string","description":"the 0x… transaction hash"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XbpS09RWohDRFeIcN1jd4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns full transaction status, block info, gas used, fee paid, and — for failed transactions — the plain-text revert reason recovered by replaying the call against its block.","exampleAgentPrompt":"Can you check what happened to my transaction 0x4a3b...f9c2 on Base — did it succeed, and if it failed, what was the revert reason?","exampleUseCases":[{"title":"Debug failed smart contract call","prompt":"My transaction 0xabc123...def456 on Ethereum failed — can you replay it and tell me the exact revert reason in plain English?"},{"title":"Confirm transaction and fee paid","prompt":"Did my Polygon transaction 0x9f8e...1234 go through? If so, what block was it in and how much did I end up paying in gas fees?"},{"title":"Audit on-chain transaction outcome","prompt":"I need to verify whether transaction 0x7c2d...8b90 on Arbitrum succeeded and get the gas used and total fee paid for my records."}],"resultDescription":"Returns the transaction status (success/failure), block number, gas used, total fee paid, and — critically for failed transactions — the human-readable revert reason recovered by replaying the call against the original block. This goes beyond a raw receipt by decoding the actual failure message from the EVM.","failureModes":["Invalid or malformed tx_hash returns an error — hash must be a valid 0x-prefixed hex string","Transaction not found on the specified chain (wrong chain selected)","Revert reason unavailable if the node cannot replay the historical block (archive node limitation)","Unsupported chain identifier returns a validation error","Network or RPC timeout causing delayed or missing response"],"whenToPreferThis":"Use this endpoint when you need to understand why a transaction failed and need the decoded revert reason — not just a pass/fail status. Unlike raw JSON-RPC eth_getTransactionReceipt calls, this endpoint replays the transaction against its block to recover the plain-text revert message. Prefer it over a generic Multi-Chain RPC Gateway when the goal is diagnosis rather than raw data, and over the Transaction Pre-flight Check when the transaction has already been submitted.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:59.728Z","isFirstParty":false}