Review

Cancel a review

Stop a review: its quick checks, its deep checks and its citation checks. Returns the review as it stands afterwards, status: cancelled.

You are charged only for what it delivered before the cancel: quick checks it served, deep checks that finished, citations it checked. The rest is refunded or never charged. A review that had already finished is returned unchanged (completed or failed), so the body always says what happened; cancelling again is safe. A review's deep check cannot be cancelled on its own (POST /verify/{task_id}/cancel answers 409 use_review_cancel): cancel the review.

Versions. 200: 2026-10-11 receives ReviewFullOut, 2026-05-13 receives ReviewFullOutLegacy; 403: 2026-10-11 receives ReviewErrorOut, 2026-05-13 receives ReviewErrorOutLegacy; 404: 2026-10-11 receives ReviewErrorOut, 2026-05-13 receives ReviewErrorOutLegacy; 410: 2026-10-11 receives ReviewErrorOut, 2026-05-13 receives ReviewErrorOutLegacy; default: 2026-10-11 receives ErrorOut, 2026-05-13 receives ErrorOutLegacy.

post/api/v1/reviews/{review_id}/cancel

Request

  • Base URL: https://lenz.io
  • URL: https://lenz.io/api/v1/reviews/{review_id}/cancel
  • Auth: HTTP bearer

Path parameters

review_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

review_idstring required
status'queued' | 'assessing' | 'verifying' | 'completed' | 'failed' | 'cancelled' required

verifying: deep checks or citation checks are running. cancelled: you cancelled it (POST /reviews/{review_id}/cancel); only what it delivered before that is charged.

outcome'clean' | 'issues_found' | 'incomplete' | 'unchecked' nullable required

Null until terminal. clean covers the selected claims at the policy's chosen depth. issues_found with an empty issues[] means the rows are in citation_issues[]. A deep check that reads "No Public Record" is an issue (not on the public record).

created_atstring required
completed_atstring nullable required
languagestring required

The language the review is written in, as an ISO 639-1 code. auto only while a review sent with language: "auto" on a draft that is one URL has not read its page yet; then the detected code, or en when the page could not be read.

poll_after_secondsinteger nullable required
more_claimsstring[] nullable

Claims found past max_assessments, in the draft's order: found but not checked; send them in a later request to check them. Null until the draft is read.

view'full' required

Changes

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