Get Document Verification

Retrieve the verification status and result for a submitted document

Returns the current status and verification results for a previously submitted document. When processing is complete, the response includes both the AI verdict and (if applicable) the human verdict, along with the associated truth claim and receipt identifiers.

Authentication

Requires X-API-Key header or Bearer JWT token. Tenant-scoped via X-Tenant-ID.

Path Parameters

document_id · string · required

The unique identifier of the document verification record. Format: maip-doc:ULID.

Response

document_id · string

The document verification record identifier.

agent_id · string

The agent that submitted the document.

document_type · string

The classification of the document.

file_name · string

The original file name.

document_hash · string

The SHA-256 hex digest of the document content.

status · string

Current processing status. One of: - processing — document is being analyzed - verified — document passed verification - disputed — document has conflicting signals - rejected — document failed verification (tampering, forgery, or invalidity detected)

ai_verdict · string

The AI model’s determination. One of: authentic, suspicious, forged, inconclusive. null while still processing.

ai_confidence · number

The AI model’s confidence in its verdict as a float between 0.0 and 1.0. null while still processing.

human_verdict · string

The human reviewer’s determination, if human review was triggered. One of: authentic, suspicious, forged, inconclusive. null if not yet reviewed or human review was not required.

truth_claim_id · string

The identifier of the truth claim automatically created for this document verification. Format: maip-tc:ULID.

receipt_ids · string[]

List of receipt identifiers minted during the verification process. Typically includes the verification receipt and, if applicable, the human review receipt.

created_at · string

ISO 8601 timestamp of when the document was submitted.

updated_at · string

ISO 8601 timestamp of the last status change.