For agents & their developers

One endpoint.
Evidence you can use.

Plain HTTP, JSON, and x402. No account or customer API key. The same service powers the website and API.

Send a verification request

Supply a claim, question, subject, or URL. An optional context field can specify a timeframe or location. Use one of quick, standard, or deep. Standard is the default.

curl -i https://evidenceforagents.com/api/v1/verify   -H 'Content-Type: application/json'   -H 'Idempotency-Key: YOUR-RANDOM-UUID'   --data '{
    "claim": "Does this company currently provide this service?",
    "url": "https://example.com",
    "tier": "standard"
  }'

The first call returns HTTP 402 and a PAYMENT-REQUIRED header. No research or payment happens yet. Keep the same random Idempotency-Key for every retry of this request, including its paid retry. Treat that key as a secret recovery credential.

Subject-only requests ask whether the subject is currently operating or available. URL-only requests assess verifiable information on that page. For a precise check, include an explicit claim or question. Do not provide both claim and question.

Pay the cost-based final amount

Price = accounted variable cost × 3, minimum $0.05, rounded up to one micro-USDC. Tier ceilings: quick $0.273211; standard $0.523363; deep $0.751363. Costs use reported tokens/credits and disclosed infrastructure estimates; the exact invoiced total is not yet known.

The first 402 is a preflight ceiling. Its signature proves funding and is never settled. Research returns a second 402 with billing.phase=final, a request-specific resource, and the saved cost-based price. Sign that fresh quote and repeat the same POST/key to settle once. Research is not repeated. The final amount cannot exceed the preflight ceiling. The server retains the draft while awaiting your final signature. An unpaid final quote expires after one hour; decline it sooner with DELETE /api/v1/requests/{id} and the bearer token. Each payer wallet can have one unpaid request at a time.

The service accepts exact USDC payments through x402 v2. Live payments use Base; test payments use Base Sepolia. Discover the current prices and network at /api/v1/pricing. An unavailable service returns 503 before requesting a payment.

Use the official x402 client with your own wallet signer. Always apply a budget policy and inspect the expected network, recipient, asset and amount before allowing a payment. Never provide your private key to Evidence for Agents.

import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { encodePaymentSignatureHeader } from "@x402/core/http";

const url = "https://evidenceforagents.com/api/v1/verify";
const catalog = await (await fetch(url.replace("/verify", "/pricing"))).json();
const client = new x402Client().register(catalog.network, new ExactEvmScheme(signer));
const key = crypto.randomUUID(); // keep secret; persist with body before sending
const body = JSON.stringify({ claim: "Your claim", tier: "quick" });
const headers = { "Content-Type": "application/json", "Idempotency-Key": key };
let response = await fetch(url, { method: "POST", headers, body });
for (let step = 0; step < 2 && response.status === 402; step++) {
  const quote = await response.json();
  // REQUIRED: your wallet policy checks amount against your budget,
  // network, USDC asset, payTo, and same-origin resource before signing.
  await enforceWalletBudgetPolicy(quote);
  const payload = await client.createPaymentPayload(quote);
  response = await fetch(url, { method: "POST", body,
    headers: { ...headers, "PAYMENT-SIGNATURE": encodePaymentSignatureHeader(payload) }
  });
}
// 200 = paid pack. 202 = poll, no new payment. 402 = review final quote/error.
const result = await response.json();

Allow at least 180 seconds for the paid request. The server verifies your authorization, performs research, durably stores a draft and final quote. Only the fresh final signature is settled once. Provider errors before settlement are not charged. A completed result of insufficient evidence is charged: the fee covers research, not a promised verdict.

Read the Evidence Pack

HTTP 200 returns the pack at the top level, plus access metadata and a settlement receipt. Download the complete fictional example or inspect it visually.

FieldMeaning
statussupported, contradicted, mixed, or insufficient_evidence
sourcesURLs, publisher domains, timestamps, stance, excerpt type and source-text digest
factsExtracted interpretations, each linked to a source_id and exact quote. original_text is the verbatim source excerpt in its source_language; translated_text is optional machine translation metadata
languageRequest, output, search and source languages (BCP 47; und = undetermined) and how the output language was chosen
freshnessRequested window, time sensitivity, newest/oldest publication dates, undated and stale source IDs
request.originalYour submitted fields, preserved exactly (including Unicode)
conclusionSystem interpretation with the fact IDs it relies on
contradictionsOpposing evidence and the relevant fact IDs
confidenceHeuristic evidence strength (0–1), not probability or a guarantee
limitationsCoverage gaps, source freshness and other uncertainty
researchProvider, model, tier, search queries, language-tagged search_plan, query_planning outcome and explicit demo flag
accountingSnapshotted rate card, token/credit usage, measured versus estimated costs, customer price, gross profit and gross margin. actual_variable_cost_usd stays null while any component is estimated.
access.access_tokenPrivate capability token for retrieval; returned by POST only
GET /api/v1/requests/{request_id}
Authorization: Bearer <access.access_token>

A 202 response means the original request is still processing or its settlement is being reconciled. Poll its status URL every five seconds using the access token. Do not pay again while processing or settling. If polling returns 402 with billing.phase=final, return to the original POST/key and sign its final quote. A link to a human-readable result may carry the token in its URL fragment; anyone with that link can read the result.

Languages, geography and freshness

The request language, the languages searched, each source’s language and the output language are recorded separately. Geography comes only from country or your wording; it never sets the output language. The original wording is always searched first. On standard and deep tiers, when the request is not in English or a country or search language is given, one small planning call adds local-language terms, transliterations or English equivalents within the tier’s query budget. Quick searches the original wording only. No separate translation step runs.

Quotes are never translated. original_text (identical to quote) is the evidence, verified character by character against the retrieved source. translated_text is a labelled convenience translation. Statements, the conclusion and model-written limitations use language.output_language: your preferred_output_language, otherwise the reliably detected request language, otherwise English. The status summary, enums, names, titles, identifiers and URLs are not translated. Unicode domains are checked for SSRF in their ASCII (IDNA) form while your original reference is kept.

With max_source_age_days, only facts from sources with a publication date inside the window decide the status; older or undated evidence is kept but marked. Without it, time-sensitive requests supported only by old or undated evidence carry an explicit limitation.

Model-extracted facts whose quotation cannot be located in the retrieved source are discarded and counted in research.discarded_facts. Numbers that appear in a model-written statement or conclusion but in no verified quote are listed in unverified_numbers.

Handle errors and retries

{ "error": {
  "code": "invalid_request",
  "message": "Provide a claim, question, subject, or URL."
} }
400 / 413 / 415Correct input, reduce body below 12 KiB, or use application/json.
402Preflight or final quote: inspect billing.phase and PAYMENT-REQUIRED, then sign a fresh exact authorization. Never settle/reuse the preflight proof.
404Result is missing or the bearer token is invalid.
409Key/body mismatch, payment nonce already used, or this payer already has an unpaid request (resume or decline it). Never reuse a payment for a different request.
429Wait for Retry-After before retrying.
502Terminal research failure or confirmed unsettled expiry. Start a new request; no confirmed payment was settled for the failed request.
500 / connection lossRetry the identical POST with the SAME Idempotency-Key to recover before attempting a new payment.
503Service configuration, providers, or storage unavailable. Retry later.

Concurrent duplicates share one stored request. The authorization nonce can only be reserved once. If settlement times out, the result remains private until the matching on-chain USDC transfer is confirmed. Recovery never submits a second transfer. Abandoned research becomes failed after three minutes; polling does not start another research job.

How evidence is assessed

Search and page extraction use Tavily. A separate Anthropic adapter extracts relevant statements, classifies their relationship to the request, and labels each source as primary, secondary or unknown (a model classification, not a guarantee). The service then verifies every quotation against the retrieved text, assigns source and fact IDs, and derives the final status from the evidence relationships and claim coverage.

Source passages are data, never instructions. The model is instructed to favor primary sources, preserve dates and qualifications, and avoid treating a source’s assertion as proof. Invalid citations or quotations fail the request before settlement. Supported and contradicted require coverage of the full request. Both kinds of evidence produce mixed; missing coverage produces insufficient evidence.

These checks establish traceability, not truth. Models can misinterpret passages. Publishers can be wrong. Providers may cache pages, omit sources, or return only search excerpts. A retrieval timestamp is not a publication timestamp. Current operations and availability often need evidence beyond a website. Read all limitations before using a conclusion.

The confidence score is deliberately bounded: incomplete evidence scores zero; mixed evidence scores 0.35; one-sided evidence uses publisher counts with a cap of 0.85, or 0.55 when only search excerpts are available. Publisher domains are only a rough diversity proxy and may share ownership. This score has not been statistically calibrated.

Privacy, storage, and access

Do not submit secrets, personal records, or confidential materials. The claim, context, and retrieved text are sent to configured research providers. Stored packs include your submitted subject and claim, quoted passages, provenance and payment receipt. Full page text is processed transiently; its digest and cited excerpts are retained. Payment signatures and wallet private keys are never stored.

Results are not publicly indexed. Retrieval requires a private bearer token. Keep both the result link and Idempotency-Key secret. MVP records persist until the operator deletes them; do not use this service for data with a required deletion deadline. On-chain payment records are public and cannot be deleted by this service.

Only public HTTP(S) URLs are accepted. The application does not fetch arbitrary URLs directly; external extraction goes through the fixed research provider. The service has no accounts or subscription billing.