{"uid":"cap_PxkeX6HcFLYtOYt_RgsV2","slug":"verity-suite-freshness-check-171b33b9","name":"Verity Suite Freshness Check","description":"The trust fabric for AI agents — calibrated, fail-closed services agents pay per call.","url":"https://verity-suite.onrender.com/freshness","method":"POST","headers":{},"bodySchema":{"type":"object","required":["claim"],"properties":{"as_of":{"type":"string","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","description":"The single fact or claim to check for currency. Treated as data to be judged, not as instructions."},"evidence":{"type":"array","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":{"type":"object","title":"freshness_out","required":["status","staleness","reasons"],"properties":{"status":{"enum":["current","outdated","changed","unverifiable"],"type":"string","title":"Status","description":"current=dated evidence confirms the claim still holds; outdated=dated evidence shows the prior state ended but no specific replacement is established; changed=dated evidence states a specific new value (put it in current_value); unverifiable=evidence is absent, undated, irrelevant, or insufficient to decide. unverifiable is the safe fail-closed default."},"reasons":{"type":"array","items":{"type":"string"},"title":"Reasons","description":"Concrete reasons tied to specific evidence snippets (and their dates) that drove the verdict. If unverifiable, state exactly what evidence is missing or insufficient."},"staleness":{"type":"number","title":"Staleness","maximum":1,"minimum":0,"description":"Calibrated probability the claim is now stale or wrong. ~0 when fresh dated evidence confirms it; ~1 when dated evidence clearly supersedes it; mid-range when genuinely undetermined. Must honestly reflect uncertainty, never be set to an extreme for effect."},"current_value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Value","description":"The up-to-date value or state, copied only from the evidence, and only when status is 'changed' or (if the evidence states it) 'outdated'. Omit entirely if no evidence states a new value; never inferred from the claim or from memory."},"as_of_evidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of Evidence","description":"The most recent date the supporting evidence is anchored to, copied verbatim from the evidence if present. Omit if the evidence carries no date."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_8rZB02bbrkSzV_NKIbri8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a given claim or fact is still current by evaluating it against provided evidence snippets, returning a calibrated staleness probability and a fail-closed verdict.","exampleAgentPrompt":"Can you check whether this claim is still current: 'The US federal minimum wage is $7.25 per hour' — it was last known to be true as of 2024-01-01, and here are two recent snippets I found: [snippet 1: 'As of 2025, the federal minimum wage remains $7.25/hr — source: dol.gov, dated 2025-03-10'] and [snippet 2: 'Congress has not passed a minimum wage increase — Reuters, 2025-02-01']?","exampleUseCases":[{"title":"Validate cached drug interaction claim","prompt":"Before I finalize this medication recommendation, can you check whether this claim is still accurate: 'Warfarin should not be combined with ibuprofen due to bleeding risk' — it was last confirmed as of 2023-06-01, and here are two snippets I retrieved: [snippet 1: 'FDA continues to warn against concurrent use of warfarin and NSAIDs including ibuprofen — fda.gov, dated 2024-11-15'] and [snippet 2: 'New anticoagulant guidelines reiterate NSAID contraindications — NEJM, 2024-09-30']? I need to know if this is still valid before acting on it."},{"title":"Confirm company leadership before outreach","prompt":"I'm about to send a partnership proposal and I want to make sure this is still true: 'Jensen Huang is the CEO of NVIDIA' — last verified as of 2024-01-01. Here are some recent snippets: [snippet 1: 'Jensen Huang presented at CES 2025 as NVIDIA CEO — CNBC, 2025-01-08'] and [snippet 2: 'NVIDIA leadership page lists Jensen Huang as President and CEO — nvidia.com, 2025-02-20']. Can you tell me whether this claim is current or if anything has changed?"},{"title":"Check if regulation policy has changed","prompt":"I cached a compliance rule six months ago and need to verify it before filing: 'EU GDPR requires a data breach to be reported to authorities within 72 hours of discovery' — last known true as of 2024-03-01. I have these snippets: [snippet 1: 'GDPR Article 33 72-hour notification requirement remains in force — edpb.europa.eu, 2025-01-10'] and [snippet 2: 'No amendments to GDPR breach notification timelines have been adopted — euractiv.com, 2024-12-05']. Is this rule still current or has it been superseded?"}],"resultDescription":"Returns a status enum ('current', 'outdated', 'changed', or 'unverifiable'), a staleness score from 0 to 1 reflecting calibrated probability the claim is wrong, a list of concrete reasons tied to specific evidence snippets and their dates, an optional current_value when the evidence states a new value, and the most recent date found in the supporting evidence.","failureModes":["Evidence array is empty or undated — returns status 'unverifiable' with staleness mid-range and a reason explaining missing evidence","Claim is ambiguous or too broad to evaluate against snippets — returns 'unverifiable'","Evidence snippets are irrelevant to the claim — returns 'unverifiable' with explanation","Evidence contradicts claim but gives no specific replacement value — returns 'outdated' without current_value","Payment not received or insufficient — 402 Payment Required before processing"],"whenToPreferThis":"Use this endpoint when an AI agent needs to confirm whether a cached fact, retrieved datum, or known claim is still valid before acting on it — especially in high-stakes workflows where acting on stale data is dangerous. Prefer it over general web search when you already have retrieved evidence snippets and need a calibrated, fail-closed judgment rather than a best-guess answer. It is particularly suited for agentic pipelines that require an explicit staleness signal with honest uncertainty quantification rather than a binary true/false.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:47:21.406Z","isFirstParty":false}