API Reference

Alpha

Verify

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Cancel Verify Job

VerifyCancelResponse Alpha.Verify.Cancel(VerifyCancelParamsparameters, CancellationTokencancellationToken = default)

POST/api/alpha/verify/{job_id}/cancel

Cancel a running Verify job.

Stops processing and marks the job as CANCELLED. Returns the updated job. Jobs already in a terminal state (COMPLETED, FAILED, CANCELLED) cannot be cancelled.

ParametersExpand Collapse

VerifyCancelParams parameters

required string jobID

string? organizationID

string? projectID

ReturnsExpand Collapse

class VerifyCancelResponse:

Response for a Verify job.

required string ID

Unique identifier

required Configuration Configuration

Verify configuration used for this job

string? TargetPages

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

Tier Tier

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"Agentic

"fast"Fast

required DocumentInputType DocumentInputType

Type of the document input (FILE)

One of the following:

"file_id"FileID

"parse_job_id"ParseJobID

"url"Url

required string FileInput

ID of the input file

required string ProjectID

Project this job belongs to

required Status Status

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

One of the following:

"CANCELLED"Cancelled

"COMPLETED"Completed

"FAILED"Failed

"PENDING"Pending

"RUNNING"Running

required string UserID

User who created this job

DateTimeOffset? CreatedAt

Creation datetime

formatdate-time

string? ErrorMessage

Error message if job failed

Result? Result

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.

required string DetectorVersion

Version of the detector that produced the result

required Double OverallScore

Overall doctoring likelihood (0 to 1)

maximum1

minimum0

required Verdict Verdict

Overall verdict for the document

One of the following:

"AUTHENTIC"Authentic

"DOCTORED"Doctored

"LIKELY_DOCTORED"LikelyDoctored

"NO_STRONG_SIGNAL"NoStrongSignal

"SUSPICIOUS"Suspicious

CompositeScores CompositeScores

Composite scores, each answering one question about the document

AIGenerated AIGenerated

Was this content synthesized by a generative model?

Boolean Applicable

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

Double? Score

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

maximum1

minimum0

DocumentCoherence DocumentCoherence

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

Boolean Applicable

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

Double? Score

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

maximum1

minimum0

DocumentMetadata DocumentMetadata

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

Boolean Applicable

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

Double? Score

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

maximum1

minimum0

KnownFraud KnownFraud

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

Boolean Applicable

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

Double? Score

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

maximum1

minimum0

ManuallyEdited ManuallyEdited

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

Boolean Applicable

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

Double? Score

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

maximum1

minimum0

Recapture Recapture

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

Boolean Applicable

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

Double? Score

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

maximum1

minimum0

Double Confidence

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

maximum1

minimum0

string? Error

Error detail when the analysis could not complete

Long PageCount

Number of analysed pages (1 for images/docx)

minimum1

IReadOnlyList<PageDimension> PageDimensions

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

required Long Height

Rendered page height in pixels

required Long Page

0-based page index (0 for standalone images)

required Long Width

Rendered page width in pixels

string Reasoning

Explanation of the verdict

IReadOnlyList<SuspectRegion> SuspectRegions

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

required IReadOnlyList<Long> Bbox

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

required string Explanation

Human-readable explanation of what makes this region suspect

required string Kind

Kind of anomaly detected in this region

required Long Page

0-based page index (0 for standalone images)

required Double Score

Suspicion score for this region (0 to 1)

maximum1

minimum0

required string Source

Detector that flagged this region

Boolean Primary

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

string Review

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

Double? SyntheticScore

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

Double? TamperingScore

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

string? TransactionID

Idempotency key

DateTimeOffset? UpdatedAt

Update datetime

formatdate-time

Cancel Verify Job

C#

HTTP

TypeScript

Python

Go

Java

C#

CLI Tool

VerifyCancelParams parameters = new() { JobID = "job_id" };

var response = await client.Alpha.Verify.Cancel(parameters);

Console.WriteLine(response);

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