Free trial verify — no key, no payment.

Runs the verify pipeline for a single claim without an API key or payment. Rate-limited per caller IP. Shared trial-account content is never reused through the verdict caches. Completed responses add trial usage and upgrade information to a verdict; receipts use the shared trial_shared subject. A response timeout instead returns 504 outcome_unknown without a receipt. Unlike prepaid requests, this route has no durable polling contract.

post/v1/verify/trial

Request

  • Base URL: https://api.verify-api.dev
  • URL: https://api.verify-api.dev/v1/verify/trial
  • Auth: none required

Request body

claimstring required

Response

Verdict + trial metadata.

idstring required

Verdict ULID, prefixed vrf_.

verdict'supported' | 'refuted' | 'insufficient_evidence' | 'out_of_scope' | 'malformed' required
confidencenumber required

0-1. Below CONFIDENCE_FLOOR (default 0.75) is downgraded to insufficient_evidence.

source_urlstring uri nullable

URL of the source that yielded the verdict.

published_datestring date nullable
exact_quotestring nullable

Verbatim passage from the source. Guaranteed to appear character-for-character in the extracted source text.

reasoningstring nullable

1-2 sentence explanation of the verdict.

cache'miss' | 'exact' | 'semantic' required

Which cache tier served this verdict, if any. Semantic hits are cosine ≥ 0.92 within the same as_of bucket.

billed_usdnumber required

Amount billed for this call, in dollars. 0 for insufficient_evidence / out_of_scope / malformed. May exceed base price at recent/fresh tiers.

as_of_bucketstring required

The temporal bucket the claim was assigned to.

freshness_tier'default' | 'recent' | 'fresh'

Which freshness tier the pipeline actually ran at. May differ from the requested tier when the resolver downgrades (e.g. cache hit within max_age_seconds).

price_multipliernumber

Multiplier applied to the base price for this verdict. 1 for default tier, 2 for recent, 5 for fresh (see /v1/pricing).

verdict_age_secondsinteger nullable

Age of the verdict in seconds when it was returned. 0 for miss (fresh compute). Non-zero for cache hits.

Example response

{
  "id": "vrf_01J8Z3W9YQKTB7ZK7C6E7N9J5R",
  "as_of_bucket": "annual:2026-Q3"
}

Changes

No recorded changes to this operation across all 1 revision of this API.