{"uid":"cap_JL7wMit4Zd35yXaYJsNek","slug":"agentoracle-payment-settlement-verifier-66a2951d","name":"AgentOracle Payment Settlement Verifier","description":"AgentOracle: verify a payment transaction recorded by AgentOracle and check its Base receipt confirmation state. Returns recorded amount, payer, recipient, route, timestamp, and confirmed, pending, reverted, or temporarily unavailable on-chain state.","url":"https://aiagentoracle.ai/api/v1/settlement/:hash","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"],"type":"string"},"pathParams":{"type":"object","required":["txHash"],"properties":{"txHash":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}},"additionalProperties":false},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["txHash","payer","recipient","amountAtomic","amountUsd","asset","network","route","recordedStatus","recordedAt","onchain","limitation"],"properties":{"asset":{"type":"string"},"payer":{"type":["string","null"]},"route":{"type":"string"},"txHash":{"type":"string"},"network":{"type":"string"},"onchain":{"type":"object","required":["state","blockNumber","confirmations","checkedAt","reason"],"properties":{"state":{"enum":["confirmed","pending","reverted","unavailable"],"type":"string"},"reason":{"type":["string","null"]},"checkedAt":{"type":"string","format":"date-time"},"blockNumber":{"type":["string","null"]},"confirmations":{"type":["integer","null"]}}},"amountUsd":{"type":"number"},"recipient":{"type":"string"},"limitation":{"type":"string"},"recordedAt":{"type":"string","format":"date-time"},"amountAtomic":{"type":"string"},"recordedStatus":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mqR2NTjyzKp_2WeOdz4jI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Verifies a payment transaction recorded by AgentOracle and returns its on-chain confirmation state, amount, payer, recipient, route, and timestamp on Base.","exampleAgentPrompt":"Can you verify the AgentOracle payment transaction 0x3a2f1b...e94d and tell me whether it's confirmed on-chain, who paid, how much, and how many block confirmations it has?","exampleUseCases":[{"title":"Post-payment autonomous agent audit","prompt":"I just made an agent-to-agent payment and got transaction hash 0xabc123...def456 — can you check AgentOracle to confirm it went through on Base, who the recipient was, and what the recorded amount in USD was?"},{"title":"Disputed settlement investigation","prompt":"There's a question about whether payment 0x9f4e2c...b17a was actually settled — can you pull its AgentOracle record and tell me if it's confirmed, reverted, or still pending, along with the payer and recipient addresses?"},{"title":"Autonomous workflow payment confirmation","prompt":"My workflow just executed a USDC payment and logged hash 0x7d8e3f...c24b — please verify it on AgentOracle and confirm the on-chain state, block number, and how many confirmations it has before I proceed to the next step."}],"resultDescription":"Returns a JSON object containing the transaction hash, payer address, recipient address, amount in atomic units and USD, asset type, network, payment route, recorded timestamp, recorded status, and an on-chain object with state (confirmed, pending, reverted, or unavailable), block number, confirmation count, check timestamp, and an optional reason field.","failureModes":["Invalid or malformed txHash (not matching 0x + 64 hex chars) returns a validation error","Transaction hash not found in AgentOracle records returns a 404 or empty result","On-chain state may return 'unavailable' if the Base RPC is temporarily unreachable","Transaction may be in 'pending' state if not yet mined or confirmed","Payment to this API endpoint itself may fail if USDC balance is insufficient (x402 protocol)"],"whenToPreferThis":"Use this endpoint when you need to verify a specific payment transaction that was previously recorded by AgentOracle on Base, especially in autonomous agent workflows where payment confirmation is required before proceeding. It is ideal for post-payment audits, dispute resolution, and settlement verification for x402-protocol payments. Prefer this over generic blockchain explorers when you need AgentOracle's recorded metadata (route, recorded status, USD amount) alongside the raw on-chain state.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:33:20.670Z","isFirstParty":false}