API Reference

Alpha

Verify

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get Verify Job Details

alpha.verify.get_details(strjob_id, VerifyGetDetailsParams**kwargs) -> VerifyGetDetailsResponse

GET/api/alpha/verify/{job_id}/details

Get the raw per-signal detail for a completed Verify job.

Forensic drill-down behind the simplified result: the full evidence list, per-family sub-scores, raw localized regions, and per-page forensic heatmap overlays (presigned image URLs).

ParametersExpand Collapse

job_id: str

organization_id: Optional[str]

project_id: Optional[str]

ReturnsExpand Collapse

class VerifyGetDetailsResponse: …

Raw per-signal detail for a completed Verify job.

Forensic drill-down behind the simplified result: the full evidence list, per-family sub-scores, raw localized regions, and heatmap overlays.

job_id: str

ID of the Verify job

degraded_tools: Optional[List[DegradedTool]]

Checks that could not run on this job (with the reason). A check listed here produced no findings because it could not run, not because the document is clean

tool: str

Name of the check

reason: Optional[str]

Why the check could not run

evidence: Optional[List[Evidence]]

Evidence items produced by detection tools

code: str

Machine-readable evidence code

detail: str

Human-readable evidence detail

family: str

Signal family (e.g. metadata, splicing, compression)

score: float

Evidence strength score

tool: str

Tool that produced this evidence

hard: Optional[bool]

Whether this is hard (conclusive) evidence

metadata_tool: Optional[Dict[str, object]]

Raw values from the tool behind this finding; the shape varies by tool

heatmaps: Optional[List[Heatmap]]

Per-page forensic heatmap overlays as presigned image URLs

expires_at: datetime

The time at which the presigned URL expires

formatdate-time

kind: str

Producing signal, e.g. double_compression, ela, noise

page: int

0-based page index (0 for standalone images)

url: str

Presigned URL to the heatmap PNG (page overlay)

score: Optional[float]

Producing tool’s max score (for ranking)

page_dimensions: Optional[List[PageDimension]]

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

height: int

Rendered page height in pixels

page: int

0-based page index (0 for standalone images)

width: int

Rendered page width in pixels

regions: Optional[List[Region]]

Suspicious regions localized on rendered pages

bbox: List[int]

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

detail: str

Human-readable detail about the region

kind: str

Kind of anomaly detected in this region

page: int

0-based page index (0 for standalone images)

score: float

Region-level doctoring likelihood score

source: str

Detector/tool that produced this region

primary: Optional[bool]

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[str]

Review status/verdict for this region

review_note: Optional[str]

Free-form review note for this region

sub_scores: Optional[Dict[str, float]]

Per-family scores (metadata, ai_generation, splicing, copy_move, compression, noise, coherence, pdf_structure)

Get Verify Job Details

Python

HTTP

TypeScript

Python

Go

Java

C#

CLI Tool

import os
from llama_cloud import LlamaCloud

client = LlamaCloud(
    api_key=os.environ.get("LLAMA_CLOUD_API_KEY"),  # This is the default and can be omitted
)
response = client.alpha.verify.get_details(
    job_id="job_id",
)
print(response.job_id)

200 example

{
  "job_id": "job_id",
  "degraded_tools": [
    {
      "tool": "tool",
      "reason": "reason"
    }
  ],
  "evidence": [
    {
      "code": "code",
      "detail": "detail",
      "family": "family",
      "score": 0,
      "tool": "tool",
      "hard": true,
      "metadata_tool": {
        "foo": "bar"
      }
    }
  ],
  "heatmaps": [
    {
      "expires_at": "2019-12-27T18:11:19.117Z",
      "kind": "kind",
      "page": 0,
      "url": "url",
      "score": 0
    }
  ],
  "page_dimensions": [
    {
      "height": 0,
      "page": 0,
      "width": 0
    }
  ],
  "regions": [
    {
      "bbox": [
        0,
        0,
        0,
        0
      ],
      "detail": "detail",
      "kind": "kind",
      "page": 0,
      "score": 0,
      "source": "source",
      "primary": true,
      "review": "review",
      "review_note": "review_note"
    }
  ],
  "sub_scores": {
    "foo": 0
  }
}

Returns Examples

200 example

{
  "job_id": "job_id",
  "degraded_tools": [
    {
      "tool": "tool",
      "reason": "reason"
    }
  ],
  "evidence": [
    {
      "code": "code",
      "detail": "detail",
      "family": "family",
      "score": 0,
      "tool": "tool",
      "hard": true,
      "metadata_tool": {
        "foo": "bar"
      }
    }
  ],
  "heatmaps": [
    {
      "expires_at": "2019-12-27T18:11:19.117Z",
      "kind": "kind",
      "page": 0,
      "url": "url",
      "score": 0
    }
  ],
  "page_dimensions": [
    {
      "height": 0,
      "page": 0,
      "width": 0
    }
  ],
  "regions": [
    {
      "bbox": [
        0,
        0,
        0,
        0
      ],
      "detail": "detail",
      "kind": "kind",
      "page": 0,
      "score": 0,
      "source": "source",
      "primary": true,
      "review": "review",
      "review_note": "review_note"
    }
  ],
  "sub_scores": {
    "foo": 0
  }
}