API Reference

Alpha

Verify

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

List Verify Jobs

GET/api/alpha/verify

List Verify jobs with optional filtering and pagination.

Filter by status, specific job_ids, or creation date range.

Query ParametersExpand Collapse

created_at_on_or_after: optional string

Include items created at or after this timestamp (inclusive)

formatdate-time

created_at_on_or_before: optional string

Include items created at or before this timestamp (inclusive)

formatdate-time

expand: optional array of string

Optional fields to include (e.g. result).

job_ids: optional array of string

Filter by specific job IDs

organization_id: optional string

page_size: optional number

Number of items per page

maximum100

minimum1

page_token: optional string

Token for pagination

project_id: optional string

status: optional "CANCELLED" or "COMPLETED" or "FAILED" or 2 more

Filter by job status

One of the following:

"CANCELLED"

"COMPLETED"

"FAILED"

"PENDING"

"RUNNING"

Cookie ParametersExpand Collapse

session: optional string

ReturnsExpand Collapse

items: array of object { id, configuration, document_input_type, 9 more }

The list of items.

id: string

Unique identifier

configuration: object { target_pages, tier }

Verify configuration used for this job

target_pages: optional string

Comma-separated page numbers or ranges to analyze (1-based). Omit to analyze all pages. Ignored for non-PDF inputs.

tier: optional "agentic" or "fast"

Verify tier: ‘fast’ runs only the quick deterministic forensic checks (metadata, content integrity, container structure, pixel statistics); ‘agentic’ (default) runs the full pipeline including the learned detectors and the semantic review pass.

One of the following:

"agentic"

"fast"

document_input_type: "file_id" or "parse_job_id" or "url"

Type of the document input (FILE)

One of the following:

"file_id"

"parse_job_id"

"url"

file_input: string

ID of the input file

project_id: string

Project this job belongs to

status: "CANCELLED" or "COMPLETED" or "FAILED" or 2 more

Current job status: PENDING, RUNNING, COMPLETED, FAILED, or CANCELLED

One of the following:

"CANCELLED"

"COMPLETED"

"FAILED"

"PENDING"

"RUNNING"

user_id: string

User who created this job

created_at: optional string

Creation datetime

formatdate-time

error_message: optional string

Error message if job failed

result: optional object { detector_version, overall_score, verdict, 9 more }

Result of a Verify (doctored-document) analysis.

Raw per-signal detail (evidence list, per-family sub-scores, raw regions, forensic heatmaps) is available separately via the job’s details endpoint.

detector_version: string

Version of the detector that produced the result

overall_score: number

Overall doctoring likelihood (0 to 1)

maximum1

minimum0

verdict: "AUTHENTIC" or "DOCTORED" or "LIKELY_DOCTORED" or 2 more

Overall verdict for the document

One of the following:

"AUTHENTIC"

"DOCTORED"

"LIKELY_DOCTORED"

"NO_STRONG_SIGNAL"

"SUSPICIOUS"

composite_scores: optional object { ai_generated, document_coherence, document_metadata, 3 more }

Composite scores, each answering one question about the document

ai_generated: optional object { applicable, score }

Was this content synthesized by a generative model?

applicable: optional boolean

Whether the checks feeding this composite ran on this document. When false the document was not checked for this — not cleared of it

score: optional number

Score (0 to 1); null when the composite was not applicable

maximum1

minimum0

document_coherence: optional object { applicable, score }

Does the document’s content agree with itself (checksums, arithmetic, machine-readable zones)?

applicable: optional boolean

Whether the checks feeding this composite ran on this document. When false the document was not checked for this — not cleared of it

score: optional number

Score (0 to 1); null when the composite was not applicable

maximum1

minimum0

document_metadata: optional object { applicable, score }

Does the file’s provenance / toolchain history look suspicious? Advisory: individually weak workflow-hygiene signals

applicable: optional boolean

Whether the checks feeding this composite ran on this document. When false the document was not checked for this — not cleared of it

score: optional number

Score (0 to 1); null when the composite was not applicable

maximum1

minimum0

known_fraud: optional object { applicable, score }

Has this asset (or its template) been seen in fraud before?

applicable: optional boolean

Whether the checks feeding this composite ran on this document. When false the document was not checked for this — not cleared of it

score: optional number

Score (0 to 1); null when the composite was not applicable

maximum1

minimum0

manually_edited: optional object { applicable, score }

Was this document altered after creation (splice, retype, redact, inpaint)?

applicable: optional boolean

Whether the checks feeding this composite ran on this document. When false the document was not checked for this — not cleared of it

score: optional number

Score (0 to 1); null when the composite was not applicable

maximum1

minimum0

recapture: optional object { applicable, score }

Was the document captured through a channel that destroys forensic evidence (photo of a screen, print-then-rescan)?

applicable: optional boolean

Whether the checks feeding this composite ran on this document. When false the document was not checked for this — not cleared of it

score: optional number

Score (0 to 1); null when the composite was not applicable

maximum1

minimum0

confidence: optional number

Confidence in the verdict (0 to 1): how firmly the detected signals support the verdict bucket, independent of the doctoring likelihood itself

maximum1

minimum0

error: optional string

Error detail when the analysis could not complete

page_count: optional number

Number of analysed pages (1 for images/docx)

minimum1

page_dimensions: optional array of object { height, page, width }

Rendered pixel size per page, so region bboxes can be scaled onto the page

height: number

Rendered page height in pixels

page: number

0-based page index (0 for standalone images)

width: number

Rendered page width in pixels

reasoning: optional string

Explanation of the verdict

suspect_regions: optional array of object { bbox, explanation, kind, 5 more }

Regions that led to the suspected fraud, ranked most-suspect first, each with an explanation of what makes it suspect

bbox: array of number

Region bounding box as [x, y, w, h] in page-render pixels

explanation: string

Human-readable explanation of what makes this region suspect

kind: string

Kind of anomaly detected in this region

page: number

0-based page index (0 for standalone images)

score: number

Suspicion score for this region (0 to 1)

maximum1

minimum0

source: string

Detector that flagged this region

primary: optional boolean

Whether this region is part of the small set of decisive evidence behind the verdict — the boxes a reviewer should look at first

review: optional string

Automated reviewer verdict for this region (confirmed, dismissed, unsure, or empty). A dismissed region can still be surfaced when it is the only place to look; this label says how to read it

synthetic_score: optional number

Likelihood (0 to 1) that the document is wholly generated or fabricated rather than a capture of a real document. Null for jobs completed before this score was introduced

maximum1

minimum0

tampering_score: optional number

Likelihood (0 to 1) that a real captured document was locally edited — a genuine capture with regions altered after the fact. Null for jobs completed before this score was introduced

maximum1

minimum0

transaction_id: optional string

Idempotency key

updated_at: optional string

Update datetime

formatdate-time

next_page_token: optional string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

total_size: optional number

The total number of items available. This is only populated when specifically requested. The value may be an estimate and can be used for display purposes only.

List Verify Jobs

HTTP

HTTP

TypeScript

Python

Go

Java

C#

CLI Tool

curl https://api.cloud.llamaindex.ai/api/alpha/verify \
    -H "Authorization: Bearer $LLAMA_CLOUD_API_KEY"

200 example

{
  "items": [
    {
      "id": "id",
      "configuration": {
        "target_pages": "1,3,5-7",
        "tier": "agentic"
      },
      "document_input_type": "file_id",
      "file_input": "file_input",
      "project_id": "project_id",
      "status": "CANCELLED",
      "user_id": "user_id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "error_message": "error_message",
      "result": {
        "detector_version": "detector_version",
        "overall_score": 0,
        "verdict": "AUTHENTIC",
        "composite_scores": {
          "ai_generated": {
            "applicable": true,
            "score": 0
          },
          "document_coherence": {
            "applicable": true,
            "score": 0
          },
          "document_metadata": {
            "applicable": true,
            "score": 0
          },
          "known_fraud": {
            "applicable": true,
            "score": 0
          },
          "manually_edited": {
            "applicable": true,
            "score": 0
          },
          "recapture": {
            "applicable": true,
            "score": 0
          }
        },
        "confidence": 0,
        "error": "error",
        "page_count": 1,
        "page_dimensions": [
          {
            "height": 0,
            "page": 0,
            "width": 0
          }
        ],
        "reasoning": "reasoning",
        "suspect_regions": [
          {
            "bbox": [
              0,
              0,
              0,
              0
            ],
            "explanation": "explanation",
            "kind": "kind",
            "page": 0,
            "score": 0,
            "source": "source",
            "primary": true,
            "review": "review"
          }
        ],
        "synthetic_score": 0,
        "tampering_score": 0
      },
      "transaction_id": "transaction_id",
      "updated_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}

Returns Examples

200 example

{
  "items": [
    {
      "id": "id",
      "configuration": {
        "target_pages": "1,3,5-7",
        "tier": "agentic"
      },
      "document_input_type": "file_id",
      "file_input": "file_input",
      "project_id": "project_id",
      "status": "CANCELLED",
      "user_id": "user_id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "error_message": "error_message",
      "result": {
        "detector_version": "detector_version",
        "overall_score": 0,
        "verdict": "AUTHENTIC",
        "composite_scores": {
          "ai_generated": {
            "applicable": true,
            "score": 0
          },
          "document_coherence": {
            "applicable": true,
            "score": 0
          },
          "document_metadata": {
            "applicable": true,
            "score": 0
          },
          "known_fraud": {
            "applicable": true,
            "score": 0
          },
          "manually_edited": {
            "applicable": true,
            "score": 0
          },
          "recapture": {
            "applicable": true,
            "score": 0
          }
        },
        "confidence": 0,
        "error": "error",
        "page_count": 1,
        "page_dimensions": [
          {
            "height": 0,
            "page": 0,
            "width": 0
          }
        ],
        "reasoning": "reasoning",
        "suspect_regions": [
          {
            "bbox": [
              0,
              0,
              0,
              0
            ],
            "explanation": "explanation",
            "kind": "kind",
            "page": 0,
            "score": 0,
            "source": "source",
            "primary": true,
            "review": "review"
          }
        ],
        "synthetic_score": 0,
        "tampering_score": 0
      },
      "transaction_id": "transaction_id",
      "updated_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}