{"uid":"cap_j3WMHc0B3Uxy_McSMIIal","slug":"xrpl-transaction-lookup-with-result-code-explanation-0cc80691","name":"XRPL Transaction Lookup with Result Code Explanation","description":"One XRPL transaction, with its result code explained — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/xrpl-tx?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"hash":{"type":"string","pattern":"^[0-9A-Fa-f]{64}$"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"xrpl-tx","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.004,"receipt_id":"g402-<16hex>"},"generated_at":"<iso8601>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DLH8SyOQL7gr0-JPxcy5I","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a single XRP Ledger transaction by hash and returns its details along with a human-readable explanation of its result code","exampleAgentPrompt":"Can you look up XRPL transaction A3B4C5D6E7F80123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123 and explain what the result code means — did it succeed or fail?","exampleUseCases":[{"title":"Debugging a failed XRPL payment","prompt":"I sent an XRP payment but I'm not sure if it went through — can you look up transaction 9A1B2C3D4E5F6789012345678901234567890123456789012345678901234567 on the XRP Ledger and tell me exactly what the result code means?"},{"title":"Confirming a cross-border XRP transfer","prompt":"Please fetch the XRPL transaction with hash F1E2D3C4B5A6978801234567890ABCDEF1234567890ABCDEF1234567890ABCDE and confirm whether it was successfully included in the ledger and what the outcome was."},{"title":"Explaining a tec-code error to a user","prompt":"A customer got an error on their XRPL transaction — hash is 0A1B2C3D4E5F6A7B8C9D0E1F2A3B4C5D6E7F8A9B0C1D2E3F4A5B6C7D8E9F0A1B. Can you pull it up and give me a plain-English explanation of the result code so I can tell them what went wrong?"}],"resultDescription":"Returns a JSON object with ok status, transaction type, the full XRPL transaction data, a human-readable explanation of the result code (e.g. tesSUCCESS, tecNO_DST, etc.), and a payment receipt including tx_hash, amount in USD, and a receipt ID.","failureModes":["Invalid hash format (not 64 hex characters) — validation error returned","Transaction hash not found on the XRPL — not found error","Network timeout reaching XRPL node","Payment failure via x402 protocol — 402 response if USDC payment not provided","Malformed request body — 400 bad request"],"whenToPreferThis":"Choose this endpoint when you need to resolve a specific XRPL transaction hash and also want a human-readable explanation of the result code — not just raw ledger data. It is ideal for debugging failed transactions, confirming payment finality, or explaining tec/tes/tef error codes to end users. Prefer this over generic XRPL node APIs when you want result code interpretation bundled with the raw transaction data in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:55:43.220Z","isFirstParty":false,"canonicalSlug":"xrpl-transaction-lookup-with-result-code-explanation-0cc80691"}