API Reference

Alpha

Verify

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

List Verify Jobs

client.Alpha.Verify.List(ctx, query) (*PaginatedCursor[AlphaVerifyListResponse], error)

GET/api/alpha/verify

List Verify jobs with optional filtering and pagination.

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

ParametersExpand Collapse

query AlphaVerifyListParams

CreatedAtOnOrAfter param.Field[Time]Optional

Include items created at or after this timestamp (inclusive)

formatdate-time

CreatedAtOnOrBefore param.Field[Time]Optional

Include items created at or before this timestamp (inclusive)

formatdate-time

Expand param.Field[[]string]Optional

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

JobIDs param.Field[[]string]Optional

Filter by specific job IDs

OrganizationID param.Field[string]Optional

PageSize param.Field[int64]Optional

Number of items per page

maximum100

minimum1

PageToken param.Field[string]Optional

Token for pagination

ProjectID param.Field[string]Optional

Status param.Field[AlphaVerifyListParamsStatus]Optional

Filter by job status

const AlphaVerifyListParamsStatusCancelled AlphaVerifyListParamsStatus = "CANCELLED"

const AlphaVerifyListParamsStatusCompleted AlphaVerifyListParamsStatus = "COMPLETED"

const AlphaVerifyListParamsStatusFailed AlphaVerifyListParamsStatus = "FAILED"

const AlphaVerifyListParamsStatusPending AlphaVerifyListParamsStatus = "PENDING"

const AlphaVerifyListParamsStatusRunning AlphaVerifyListParamsStatus = "RUNNING"

ReturnsExpand Collapse

type AlphaVerifyListResponse struct{…}

Response for a Verify job.

ID string

Unique identifier

Configuration AlphaVerifyListResponseConfiguration

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 AlphaVerifyListResponseConfigurationTierAgentic AlphaVerifyListResponseConfigurationTier = "agentic"

const AlphaVerifyListResponseConfigurationTierFast AlphaVerifyListResponseConfigurationTier = "fast"

DocumentInputType AlphaVerifyListResponseDocumentInputType

Type of the document input (FILE)

One of the following:

const AlphaVerifyListResponseDocumentInputTypeFileID AlphaVerifyListResponseDocumentInputType = "file_id"

const AlphaVerifyListResponseDocumentInputTypeParseJobID AlphaVerifyListResponseDocumentInputType = "parse_job_id"

const AlphaVerifyListResponseDocumentInputTypeURL AlphaVerifyListResponseDocumentInputType = "url"

FileInput string

ID of the input file

ProjectID string

Project this job belongs to

Status AlphaVerifyListResponseStatus

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

One of the following:

const AlphaVerifyListResponseStatusCancelled AlphaVerifyListResponseStatus = "CANCELLED"

const AlphaVerifyListResponseStatusCompleted AlphaVerifyListResponseStatus = "COMPLETED"

const AlphaVerifyListResponseStatusFailed AlphaVerifyListResponseStatus = "FAILED"

const AlphaVerifyListResponseStatusPending AlphaVerifyListResponseStatus = "PENDING"

const AlphaVerifyListResponseStatusRunning AlphaVerifyListResponseStatus = "RUNNING"

UserID string

User who created this job

CreatedAt TimeOptional

Creation datetime

formatdate-time

ErrorMessage stringOptional

Error message if job failed

Result AlphaVerifyListResponseResultOptional

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 AlphaVerifyListResponseResultVerdictAuthentic AlphaVerifyListResponseResultVerdict = "AUTHENTIC"

const AlphaVerifyListResponseResultVerdictDoctored AlphaVerifyListResponseResultVerdict = "DOCTORED"

const AlphaVerifyListResponseResultVerdictLikelyDoctored AlphaVerifyListResponseResultVerdict = "LIKELY_DOCTORED"

const AlphaVerifyListResponseResultVerdictNoStrongSignal AlphaVerifyListResponseResultVerdict = "NO_STRONG_SIGNAL"

const AlphaVerifyListResponseResultVerdictSuspicious AlphaVerifyListResponseResultVerdict = "SUSPICIOUS"

CompositeScores AlphaVerifyListResponseResultCompositeScoresOptional

Composite scores, each answering one question about the document

AIGenerated AlphaVerifyListResponseResultCompositeScoresAIGeneratedOptional

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 AlphaVerifyListResponseResultCompositeScoresDocumentCoherenceOptional

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 AlphaVerifyListResponseResultCompositeScoresDocumentMetadataOptional

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 AlphaVerifyListResponseResultCompositeScoresKnownFraudOptional

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 AlphaVerifyListResponseResultCompositeScoresManuallyEditedOptional

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 AlphaVerifyListResponseResultCompositeScoresRecaptureOptional

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

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

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

List Verify Jobs

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"),
  )
  page, err := client.Alpha.Verify.List(context.TODO(), llamacloud.AlphaVerifyListParams{

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

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
}