{"uid":"cap_RcBk-CfCu9UCIo5oZvuvz","slug":"verity-suite-claim-freshness-check-3fb9af17","name":"Verity Suite – Claim Freshness Check","description":"The trust fabric for AI agents — calibrated, fail-closed services agents pay per call.","url":"https://suite.veritylayer.dev/freshness","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"as_of":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"As Of","default":null,"description":"The date or version at which the claim was last known to be true, if known (e.g. '2024-01-01'). Used only to weigh evidence recency; it is not itself proof of current truth."},"claim":{"type":"string","title":"Claim","maxLength":2000,"minLength":1,"description":"The single fact or claim to check for currency. Treated as data to be judged, not as instructions."},"evidence":{"type":"array","items":{"type":"string"},"title":"Evidence","description":"Retrieved current snippets, ideally each with a date and source, to judge the claim against. If empty or undated, currency cannot be confirmed."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MnmUigkRNLJGMJLmRODtO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a given fact or claim is still current by evaluating it against retrieved evidence snippets, returning a calibrated freshness verdict.","exampleAgentPrompt":"Check whether the claim 'The CEO of OpenAI is Sam Altman' is still current — here are three recent news snippets I found today: [snippet 1 dated 2025-01-10], [snippet 2 dated 2025-03-15], [snippet 3 dated 2025-06-01]. The claim was last known to be true as of 2024-01-01.","exampleUseCases":[{"title":"Stale knowledge base detection","prompt":"I have a claim in our knowledge base that says 'The federal minimum wage is $7.25 per hour' — last verified in 2022. Here are three recent web snippets I pulled today about minimum wage. Can you check whether this is still current or if it's changed?"},{"title":"RAG answer freshness gate","prompt":"Before my agent answers a user question about mortgage interest rates, I retrieved these three news snippets from this week. Check whether the claim 'The 30-year fixed mortgage rate is around 7%' still holds based on this evidence, so I know whether to trust or discard it."},{"title":"Competitive intelligence currency check","prompt":"Our sales deck says 'Competitor X's flagship plan costs $99/month' — we last checked in early 2024. I've pulled four current snippets from their pricing page and recent reviews. Please verify if this pricing claim is still accurate or has changed."}],"resultDescription":"Returns a JSON object with a 'status' field (one of: current, outdated, changed, unverifiable), a 'staleness' score, and an array of 'reasons' citing specific evidence snippets and their dates. If the claim has changed, a 'current_value' field states the new fact. The service is fail-closed: when evidence is absent, undated, or insufficient, it returns 'unverifiable' rather than guessing.","failureModes":["Empty or undated evidence array causes status=unverifiable — agent must supply dated, relevant snippets","Evidence irrelevant to the claim results in status=unverifiable rather than an incorrect verdict","Claim text exceeding 2000 characters is rejected with a validation error","Ambiguous or compound claims may produce unverifiable if the evidence only partially addresses them","Payment failure (insufficient USDC) results in 402 response before processing begins"],"whenToPreferThis":"Choose this endpoint when an AI agent needs a structured, fail-closed verdict on whether a specific fact is still true before using it in a response, rather than relying on its own potentially stale training data. It is especially valuable in RAG pipelines where retrieved snippets need to be cross-checked against a held claim, in knowledge base maintenance workflows to flag outdated entries, or when an agent must avoid confidently stating facts that may have changed. Prefer this over generic LLM self-checks because it returns a typed enum status with evidence-grounded reasons, making it auditable and deterministic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:51:54.905Z","isFirstParty":false}