Citecheck

Check the citations of a draft

Check whether each cited source says what the draft attributes to it.

Send text (a draft with its links: markdown links, bare URLs, doi: and doi.org forms, [n] markers with a reference list) or pairs (up to 20 statements, each with the url or doi it cites). Returns 202 with a citecheck_id; read the check at the Location (GET /citechecks/{citecheck_id}), or receive citecheck.completed / citecheck.failed at your webhook.

It costs 1 credit per checked citation: at most 1 credit per citation you send (or max_citations for a text), and a citation that could not be checked is refunded. credits.charged on the check says what it cost.

Versions. 402: 2026-10-11 receives CitecheckErrorOut, 2026-05-13 receives CitecheckErrorOutLegacy; 409: 2026-10-11 receives CitecheckErrorOut, 2026-05-13 receives CitecheckErrorOutLegacy; 429: 2026-10-11 receives CitecheckErrorOut, 2026-05-13 receives CitecheckErrorOutLegacy; 503: 2026-10-11 receives CitecheckErrorOut, 2026-05-13 receives CitecheckErrorOutLegacy; default: 2026-10-11 receives ErrorOut, 2026-05-13 receives ErrorOutLegacy.

post/api/v1/citecheck

Request

  • Base URL: https://lenz.io
  • URL: https://lenz.io/api/v1/citecheck
  • Auth: HTTP bearer

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.

Request body

textstring nullable

The draft, up to 50,000 characters, with its links (markdown links, bare URLs, doi: and doi.org forms, [n] markers with a reference list). Send exactly one of text and pairs.

max_citationsinteger nullable

With text: how many citations, in the draft's order. Default 20.

languagestring nullable

The language Lenz writes the reasoning in. English when omitted. Hints are always in English.

webhook_urlstring nullable

Omitted or null: the credential's default webhook URL. "": no webhook. A URL: citecheck.completed / citecheck.failed go there.

Response

Accepted

citecheck_idstring required
status'queued' required

The acceptance receipt, not the current state.

Changes

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