Skip to main content
GET
Get Document Verification
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

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

Response

string
The document verification record identifier.
string
The agent that submitted the document.
string
The classification of the document.
string
The original file name.
string
The SHA-256 hex digest of the document content.
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)
string
The AI model’s determination. One of: authentic, suspicious, forged, inconclusive. null while still processing.
number
The AI model’s confidence in its verdict as a float between 0.0 and 1.0. null while still processing.
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.
string
The identifier of the truth claim automatically created for this document verification. Format: maip-tc:ULID.
string[]
List of receipt identifiers minted during the verification process. Typically includes the verification receipt and, if applicable, the human review receipt.
string
ISO 8601 timestamp of when the document was submitted.
string
ISO 8601 timestamp of the last status change.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

documentId
string<uuid>
required

Document verification identifier

Response

Document verification details

verification_id
string<uuid>
document_id
string<uuid>
document_hash
string
status
enum<string>
Available options:
pending,
verified,
failed
results
object[]
verifications
object[]
claims
object[]
created_at
string<date-time>