Verify
Submit a claim for verification.
The claim goes in claim. (text is accepted as an alias — a document is text, a claim is claim; POST /extract is the endpoint that takes a document.)
Returns a task_id immediately. Poll GET /verify/status/{task_id} or supply webhook_url in the body for an asynchronous callback when the pipeline terminates.
Duplicate submissions are collapsed. With no Idempotency-Key header, the request body itself is the key: resubmitting an identical body within 10 minutes returns the original task_id instead of starting a second run. To run the same text twice on purpose, send your own Idempotency-Key — a supplied key always wins.
depth selects how much work the check does. standard (default) is the full pipeline. low searches fewer sources, skips the recovery fetch tiers and stops the debate after the opening arguments (no rebuttal round), so it comes back sooner — with less evidence behind the verdict. Framing, the adjudication panel and the conclusion run unchanged, and every step runs the same models either way; low is a volume lever, not a model downgrade.
low costs half the credits, and you are charged for the depth you REQUESTED. A claim answered from a check made in the last hour is free (unless it issues you a new warranty certificate, which is charged at the depth you requested). The completed result echoes the depth the verdict was actually produced with, which is why that field can read standard on a low request: the echo describes the evidence.
Versions. 202: 2026-10-11 receives VerifyAcceptedOut, 2026-05-13 receives VerifyAcceptedOutLegacy; 422: 2026-10-11 receives ValidationErrorOut, 2026-05-13 receives ValidationErrorOutLegacy; default: 2026-10-11 receives ErrorOut, 2026-05-13 receives ErrorOutLegacy.
Request
- Base URL: https://lenz.io
- URL: https://lenz.io/api/v1/verify
- Auth: HTTP bearer
Headers
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.
Request body
Response
Sent only to callers on 2026-05-13: the same receipt for a repeat of a /verify answered from the first submission. Every other version answers 202.
Changes
No recorded changes to this operation across all 1 revision of this API.