API Reference

Alpha

Verify

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get Verify Job

client.Alpha.Verify.Get(ctx, jobID, query) (*AlphaVerifyGetResponse, error)

GET/api/alpha/verify/{job_id}

Get a Verify job by ID.

Returns the job status and configuration. Pass expand=result to include the Verify result (overall score, verdict, confidence, composite scores, and suspect regions) when the job is complete.

Raw per-signal detail is available via GET /verify/{job_id}/details.

ParametersExpand Collapse

jobID string

query AlphaVerifyGetParams

Expand param.Field[[]string]Optional

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

OrganizationID param.Field[string]Optional

ProjectID param.Field[string]Optional

ReturnsExpand Collapse

type AlphaVerifyGetResponse struct{…}

Response for a Verify job.

ID string

Unique identifier

Configuration AlphaVerifyGetResponseConfiguration

Verify configuration used for this job

TargetPages stringOptional

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

Tier stringOptional

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:

const AlphaVerifyGetResponseConfigurationTierAgentic AlphaVerifyGetResponseConfigurationTier = "agentic"

const AlphaVerifyGetResponseConfigurationTierFast AlphaVerifyGetResponseConfigurationTier = "fast"

DocumentInputType AlphaVerifyGetResponseDocumentInputType

Type of the document input (FILE)

One of the following:

const AlphaVerifyGetResponseDocumentInputTypeFileID AlphaVerifyGetResponseDocumentInputType = "file_id"

const AlphaVerifyGetResponseDocumentInputTypeParseJobID AlphaVerifyGetResponseDocumentInputType = "parse_job_id"

const AlphaVerifyGetResponseDocumentInputTypeURL AlphaVerifyGetResponseDocumentInputType = "url"

FileInput string

ID of the input file

ProjectID string

Project this job belongs to

Status AlphaVerifyGetResponseStatus

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

One of the following:

const AlphaVerifyGetResponseStatusCancelled AlphaVerifyGetResponseStatus = "CANCELLED"

const AlphaVerifyGetResponseStatusCompleted AlphaVerifyGetResponseStatus = "COMPLETED"

const AlphaVerifyGetResponseStatusFailed AlphaVerifyGetResponseStatus = "FAILED"

const AlphaVerifyGetResponseStatusPending AlphaVerifyGetResponseStatus = "PENDING"

const AlphaVerifyGetResponseStatusRunning AlphaVerifyGetResponseStatus = "RUNNING"

UserID string

User who created this job

CreatedAt TimeOptional

Creation datetime

formatdate-time

ErrorMessage stringOptional

Error message if job failed

Result AlphaVerifyGetResponseResultOptional

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.

DetectorVersion string

Version of the detector that produced the result

OverallScore float64

Overall doctoring likelihood (0 to 1)

maximum1

minimum0

Verdict string

Overall verdict for the document

One of the following:

const AlphaVerifyGetResponseResultVerdictAuthentic AlphaVerifyGetResponseResultVerdict = "AUTHENTIC"

const AlphaVerifyGetResponseResultVerdictDoctored AlphaVerifyGetResponseResultVerdict = "DOCTORED"

const AlphaVerifyGetResponseResultVerdictLikelyDoctored AlphaVerifyGetResponseResultVerdict = "LIKELY_DOCTORED"

const AlphaVerifyGetResponseResultVerdictNoStrongSignal AlphaVerifyGetResponseResultVerdict = "NO_STRONG_SIGNAL"

const AlphaVerifyGetResponseResultVerdictSuspicious AlphaVerifyGetResponseResultVerdict = "SUSPICIOUS"

CompositeScores AlphaVerifyGetResponseResultCompositeScoresOptional

Composite scores, each answering one question about the document

AIGenerated AlphaVerifyGetResponseResultCompositeScoresAIGeneratedOptional

Was this content synthesized by a generative model?

Applicable boolOptional

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

Score float64Optional

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

maximum1

minimum0

DocumentCoherence AlphaVerifyGetResponseResultCompositeScoresDocumentCoherenceOptional

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

Applicable boolOptional

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

Score float64Optional

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

maximum1

minimum0

DocumentMetadata AlphaVerifyGetResponseResultCompositeScoresDocumentMetadataOptional

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

Applicable boolOptional

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

Score float64Optional

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

maximum1

minimum0

KnownFraud AlphaVerifyGetResponseResultCompositeScoresKnownFraudOptional

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

Applicable boolOptional

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

Score float64Optional

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

maximum1

minimum0

ManuallyEdited AlphaVerifyGetResponseResultCompositeScoresManuallyEditedOptional

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

Applicable boolOptional

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

Score float64Optional

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

maximum1

minimum0

Recapture AlphaVerifyGetResponseResultCompositeScoresRecaptureOptional

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

Applicable boolOptional

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

Score float64Optional

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

maximum1

minimum0

Confidence float64Optional

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 stringOptional

Error detail when the analysis could not complete

PageCount int64Optional

Number of analysed pages (1 for images/docx)

minimum1

PageDimensions []AlphaVerifyGetResponseResultPageDimensionOptional

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

Reasoning stringOptional

Explanation of the verdict

SuspectRegions []AlphaVerifyGetResponseResultSuspectRegionOptional

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

Bbox []int64

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 int64

0-based page index (0 for standalone images)

Score float64

Suspicion score for this region (0 to 1)

maximum1

minimum0

Source string

Detector that flagged 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

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

SyntheticScore float64Optional

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

TamperingScore float64Optional

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

TransactionID stringOptional

Idempotency key

UpdatedAt TimeOptional

Update datetime

formatdate-time

Get Verify Job

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"),
  )
  verify, err := client.Alpha.Verify.Get(
    context.TODO(),
    "job_id",
    llamacloud.AlphaVerifyGetParams{

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

200 example

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

Returns Examples

200 example

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