Verifications

Get Verification

Retrieve the full verification report for a single claim.

Returns the verdict, citations, and (under audit) the panel reasoning, debate transcript, and assessments. Same shape as the /verify webhook payload and the deprecated /library/{id} endpoint this merger replaces.

Authorization model (optional Bearer):

  • Anon callers see any listed public claim (visibility='public' AND status in {pending, published}) PLUS any API unlisted claim (visibility='public', status='hidden', source_channel='api'): unlisted is readable by verification_id, just never surfaced in listings.
  • Authed callers additionally see their own claims regardless of visibility or status.
  • Private claims, and non-API hidden public claims (retracted / pre-screen), owned by someone else return 404.

Also accepts the task_id /verify returned, in place of a verification_id. A completed run reads exactly as its verification_id would. A run that has not completed answers 409 with status (processing, needs_input or failed) and a hint, plus the failure fields when it failed; poll GET /verify/status/{task_id} for progress. A task_id that is unknown, or not yours, answers 404 with a hint at that endpoint.

Versions. 200: 2026-10-11 receives ClaimDetailOut, 2026-05-13 receives ClaimDetailOutLegacy; 409: 2026-10-11 receives VerificationNotReadyOut, 2026-05-13 receives VerificationNotReadyOutLegacy; default: 2026-10-11 receives ErrorOut, 2026-05-13 receives ErrorOutLegacy.

get/api/v1/verifications/{verification_id}

Request

  • Base URL: https://lenz.io
  • URL: https://lenz.io/api/v1/verifications/{verification_id}
  • Auth: none declared

Path parameters

verification_idstring required

Headers

X-Lenz-API-Versionstring
Example:2026-05-13

The API version to answer in, as a date. A date before 2026-10-11 (or a value that is not a date) gets 2026-05-13. See https://lenz.io/docs/api-versions.

Response

OK

verification_idstring required
claimstring required
visibilitystring
depthstring
domainstring
presumed_intentstring
verdictstring

True, Mostly True, Mixed, Mostly False or False, or No Public Record: Lenz found no public record that settles the claim, which does not make it false. It has no lenz_score (null), a confidence, and is never warranted. Version 2026-05-13 never receives it: it reads such a run as a failure (research_empty when no source was found, else research_insufficient).

confidencestring
lenz_scoreinteger nullable

1-10; null for No Public Record.

key_findingstring
executive_summarystring
warningsstring[]
suggested_rewritestring nullable

A suggested rewrite of claim that this verification's findings support, to use in place of the original sentence. It has not been verified itself: before using it, review it or run it through /verify. null for a true claim, when no correction is established, and on verifications that predate the field. On every verification, single or listed; not on /assess rows.

created_atstring
completed_atstring

When the verification finished (ISO 8601). Always set on a completed verification; a rerun moves it. API version 2026-05-13 sends modified_at instead: this time, but only when it falls on a later UTC calendar day than created_at, else null.

languagestring required

Changes

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