API Reference

Alpha

Verify

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get Verify Job Details

client.Alpha.Verify.GetDetails(ctx, jobID, query) (*AlphaVerifyGetDetailsResponse, error)

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

jobID string

query AlphaVerifyGetDetailsParams

OrganizationID param.Field[string]Optional

ProjectID param.Field[string]Optional

ReturnsExpand Collapse

type AlphaVerifyGetDetailsResponse struct{…}

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.

JobID string

ID of the Verify job

DegradedTools []AlphaVerifyGetDetailsResponseDegradedToolOptional

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 string

Name of the check

Reason stringOptional

Why the check could not run

Evidence []AlphaVerifyGetDetailsResponseEvidenceOptional

Evidence items produced by detection tools

Code string

Machine-readable evidence code

Detail string

Human-readable evidence detail

Family string

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

Score float64

Evidence strength score

Tool string

Tool that produced this evidence

Hard boolOptional

Whether this is hard (conclusive) evidence

MetadataTool map[string, any]Optional

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

Heatmaps []AlphaVerifyGetDetailsResponseHeatmapOptional

Per-page forensic heatmap overlays as presigned image URLs

ExpiresAt Time

The time at which the presigned URL expires

formatdate-time

Kind string

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

Page int64

0-based page index (0 for standalone images)

URL string

Presigned URL to the heatmap PNG (page overlay)

Score float64Optional

Producing tool’s max score (for ranking)

PageDimensions []AlphaVerifyGetDetailsResponsePageDimensionOptional

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

Height int64

Rendered page height in pixels

Page int64

0-based page index (0 for standalone images)

Width int64

Rendered page width in pixels

Regions []AlphaVerifyGetDetailsResponseRegionOptional

Suspicious regions localized on rendered pages

Bbox []int64

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

Detail string

Human-readable detail about the region

Kind string

Kind of anomaly detected in this region

Page int64

0-based page index (0 for standalone images)

Score float64

Region-level doctoring likelihood score

Source string

Detector/tool that produced this region

Primary boolOptional

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

Review stringOptional

Review status/verdict for this region

ReviewNote stringOptional

Free-form review note for this region

SubScores map[string, float64]Optional

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

Get Verify Job Details

Go

HTTP

TypeScript

Python

Go

Java

C#

CLI Tool

package main

import (
  "context"
  "fmt"

  "github.com/run-llama/llama-parse-go"
  "github.com/run-llama/llama-parse-go/option"
)

func main() {
  client := llamacloud.NewClient(
    option.WithAPIKey("My API Key"),
  )
  response, err := client.Alpha.Verify.GetDetails(
    context.TODO(),
    "job_id",
    llamacloud.AlphaVerifyGetDetailsParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.JobID)
}

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
  }
}