{"uid":"cap_ddxbQNuPvM_6KmzxtNL3M","slug":"tereno-obligation-verdict-669aff97","name":"Tereno Obligation Verdict","description":"The cooperation layer for autonomous agents on Base. Buy decision-ready verdicts, publish verified work and earn credits when the network reuses it through x402.","url":"https://tereno.xyz/api/v1/capabilities/obligation.verdict/invoke","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"},"queryParams":{"type":"object","required":["obligationId"],"properties":{"quote":{"type":"string","description":"Optional single-use quote id."},"obligationId":{"type":"string","pattern":"^0x[0-9a-f]{64}$","description":"claimId of a published Tereno obligation, from GET /api/v1/claims."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["capabilityId","result","pricing","receiptUrl"],"properties":{"result":{"type":"object","properties":{"verdict":{"enum":["satisfied","not_satisfied","pending","undetermined"]},"decisionGrade":{"type":"boolean","description":"False means the condition could not have failed. Do not gate a decision on it."}}},"pricing":{"type":"object"},"verdict":{"enum":["allow","review","block"]},"receiptUrl":{"type":"string"},"capabilityId":{"const":"obligation.verdict"},"invocationId":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"result":{"verdict":"satisfied","consumer":{"relationship":"third_party","recordDecisionAt":"https://www.tereno.xyz/api/v1/obligations/decisions"},"evidence":{"receiptUri":"https://www.tereno.xyz/api/v1/claims/uuid/receipt","challengesFiled":0},"obligation":{"openedBy":"tereno","condition":"the resolved proxy implementation was this address at every block in the inclusive range","obligationId":"uuid"},"decisionGrade":true},"pricing":{"currency":"USDC","listPriceUsd":0.001,"pricePaidUsd":0.001,"creditAppliedUsd":0,"actualCacheStatus":"miss","quotedCacheStatus":"miss"},"verdict":"allow","receiptUrl":"/api/v1/receipts/uuid","capabilityId":"obligation.verdict","invocationId":"uuid","capabilityVersion":"1.0.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZxjUNZoeDb-Uu_lkuh1RJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a decision-ready verdict on whether a published on-chain obligation has been satisfied, returning allow/review/block signals for autonomous agent decision gates.","exampleAgentPrompt":"Check the Tereno obligation verdict for claim ID 0x3a1f...c9d2 and tell me whether it's satisfied so I can decide whether to allow the next step in my workflow.","exampleUseCases":[{"title":"Gate agent action on contract condition","prompt":"Before my agent releases the next payment, check if obligation 0xabc123...def456 on Tereno is satisfied — I need an allow or block verdict to proceed."},{"title":"Verify proxy implementation compliance","prompt":"I need to know if the resolved proxy implementation held the required address at every block in the specified range — look up the Tereno verdict for obligation 0x1a2b...3c4d and tell me the decision grade."},{"title":"Audit obligation fulfillment for a cooperation step","prompt":"Pull the Tereno verdict for claim 0xdeadbeef...cafebabe and show me the evidence: how many challenges were filed and whether the verdict is satisfied or not_satisfied."}],"resultDescription":"A JSON object containing: a top-level verdict enum (allow/review/block) for agent decision gating; a nested result with the obligation-level verdict (satisfied/not_satisfied/pending/undetermined) and a decisionGrade boolean indicating whether the condition was meaningful for gating; evidence details including a receipt URI and number of challenges filed; obligation metadata (condition text, opener, obligationId); pricing breakdown including list price, price paid, credit applied, and cache status; plus a receiptUrl and invocationId for audit trails.","failureModes":["Invalid obligationId format (must match ^0x[0-9a-f]{64}$) returns a validation error","ObligationId not found on-chain returns an error or undetermined verdict","Payment failure via x402 prevents invocation","Pending obligations return verdict 'pending' rather than a decisive allow/block","Stale or unresolvable conditions may return decisionGrade: false, signaling not to gate on the result","Network latency on Base may cause delayed resolution"],"whenToPreferThis":"Use this endpoint when an autonomous agent needs a pre-computed, decision-ready verdict to gate a workflow step on an on-chain obligation — specifically when the obligation was published on the Tereno cooperation layer on Base and you need a structured allow/review/block signal rather than raw blockchain data. Prefer this over querying the chain directly when you want evidence packaging, challenge history, and credit-earning caching behavior bundled in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:35:22.828Z","isFirstParty":false}