Check quotes in a batch

This checks source grounding. It does not independently search for evidence that the quoted assertion is true. Provide source_text, url, or asset_id for each quote. For retained evidence, supply all three immutable IDs: source_version_id, representation_id, and source_unit_id.

fuzzy and reflowed matches remain needs_review. Omit meaning when no assessment is available; the result reports not_checked. Caller-supplied meaning accepts only changed or ambiguous, never a self-certified faithful.

evidence_scope: {folder_id, include_descendants: true} supplies filed folder evidence for items with no source. Each matched item returns its folder citation; no match returns an item error. App keys require this scope and read plus verify permission. Their items must omit source_text, url, asset_id, source_version_id, representation_id and source_unit_id. Unbound account keys retain own-source verification.

The folder organization billing owner pays an app-key batch. Folder visibility, permissions and an active payer are checked before reservation. Idempotency-Key preserves the original app principal and resolved payer; a changed payer on replay returns 409 before another reservation or dispatch. Results remain an array, with operation and credit receipt headers preserved.

Illustrative response, not a recorded API result.

[
  {
    "id": "1",
    "quote": "reduced HbA1c by 1.2%",
    "binding": {
      "grounded": true,
      "method": "fuzzy",
      "score": 0.67,
      "matched_text": "A 1.2% reduction in HbA1c was observed versus placebo."
    },
    "verification": {
      "layer": "bound",
      "band": "needs_review",
      "confidence": 80,
      "grounded": true,
      "meaning": "not_checked"
    },
    "feedback_token": "eyJxIjoi..."
  }
]

Illustrative response, not a recorded API result.

[
  {
    "id": "ocr-example",
    "quote": "Revenue increased by 18 percent.",
    "binding": {
      "grounded": true,
      "method": "reflowed",
      "reading": "body",
      "score": 1,
      "matched_text": "Revenue increased\nAnnual report\nby 18 percent.",
      "rescue": {
        "attempted": true,
        "rescued": true,
        "reading": "Revenue increased by 18 percent.",
        "transformations": [
          {
            "kind": "drop",
            "atLine": 1,
            "line": "Annual report",
            "source": "element_label"
          },
          {
            "kind": "join",
            "afterLine": 0
          }
        ],
        "droppedLines": [
          "Annual report"
        ],
        "retainedSpans": [
          {
            "page": 1,
            "fromLine": 0,
            "toLine": 0
          },
          {
            "page": 1,
            "fromLine": 2,
            "toLine": 2
          }
        ],
        "calibrationKey": "illustrative-prepared-artifact-key",
        "basis": "code",
        "model": null,
        "decidedAt": "2026-09-19T00:00:00.000Z"
      }
    },
    "verification": {
      "layer": "bound",
      "band": "needs_review",
      "confidence": 80,
      "grounded": true,
      "meaning": "not_checked"
    },
    "feedback_token": "illustrative-token"
  }
]

An array of results, one per item. Each result includes binding, verification, and feedback_token. This endpoint returns an array, not an object with a top-level usage receipt.

For 400, check the request fields and source identifiers. For 401, check your API key. For 429, wait for the retry interval. See the errors guide before retrying a billable request. App keys require evidence_scope (403 APP_KEY_EVIDENCE_SCOPE_REQUIRED) and must not provide their own source fields (403 APP_KEY_BATCH_SOURCE_FORBIDDEN). Missing read or verify permission returns 403 KEY_SCOPE_DENIED; a folder outside the key scope returns 404 FOLDER_NOT_FOUND. No active folder org payer returns 403 FOLDER_BILLING_OWNER_UNAVAILABLE. Reusing Idempotency-Key with a changed body or app-batch billing owner returns 409.