Verify

Get Status

Poll processing status for a submitted verification.

Five shapes keyed on status — processing, needs_input, completed, failed, cancelled (2026-05-13 reads a cancelled run as failed) — and only the fields belonging to the current one are present (see the response schema). A field that does not belong to the current shape is omitted rather than sent as null, so a client may test for presence.

Versions. 200: 2026-10-11 receives StatusOut, 2026-05-13 receives StatusOutLegacy; default: 2026-10-11 receives ErrorOut, 2026-05-13 receives ErrorOutLegacy.

get/api/v1/verify/status/{task_id}

Request

  • Base URL: https://lenz.io
  • URL: https://lenz.io/api/v1/verify/status/{task_id}
  • Auth: HTTP bearer

Path parameters

task_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

status'processing' | 'needs_input' | 'completed' | 'failed' | 'cancelled' required
task_idstring required
reason'multi_claim' nullable
hintstring nullable

Changes

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