# Verity Suite – Claim Freshness Check

> Verity Suite – Claim Freshness Check is a paid API for AI agents from suite.veritylayer.dev, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-14).

Checks whether a given fact or claim is still current by evaluating it against retrieved evidence snippets, returning a calibrated freshness verdict.

## Facts

- Endpoint: POST https://suite.veritylayer.dev/freshness
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/verity-suite-claim-freshness-check-3fb9af17
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RcBk-CfCu9UCIo5oZvuvz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability verity-suite-claim-freshness-check-3fb9af17 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

The trust fabric for AI agents — calibrated, fail-closed services agents pay per call.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/verity-suite-claim-freshness-check-3fb9af17/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from suite.veritylayer.dev](https://www.zero.xyz/host/suite.veritylayer.dev/llms.txt)