Skip to main content
POST
Document Verification V2
Document Verification V2 evaluates the uploaded document images and returns structured results in the response data object. Use these fields to understand both what was extracted from the document and why the overall verificationStatus was assigned.

Verification statuses

verificationStatuses gives a high-level result for each major stage. Each item includes a verificationType and a verificationStatus of Passed, Failed, or Not Performed (when the check does not apply or could not run):

Image quality

imageQuality reports capture-level checks so you can tell if a failure came from a poor photo rather than a fraudulent document. Typical checks include focus, glare, portrait presence, document bounds, perspective, resolution, and colorness.

Security checks

securityChecks reports authenticity and fraud signals, including:
  • Document image patterns
  • Photo forgery
  • Human face in the portrait
  • Document liveness
  • Black-and-white copy detection
  • Occlusion (blocked or covered areas)

Extracted data and document type

extractedData returns OCR text fields (often from both visual and barcode sources), cropped images such as the portrait and document sides, and barcode payloads when available. documentType identifies the recognized document name, country, year, and type (for example, identity_card).

Authorizations

Authorization
string
header
required

Use Bearer {your_api_token} in the Authorization header.

Headers

Accept
string
default:application/json

Body

multipart/form-data
imageFrontSide
file
required

Front-side document image file (JPG, JPEG, or PNG).

trustFlowId
integer
required

Identifier used to categorize or group requests for tracking or reporting.

trustValidationId
string
required

A unique ID used to identify your verification request.

imageBackSide
file

Back-side document image file (JPG, JPEG, or PNG). Required when the document type has a back side.

Response

200 - application/json

Document verification processed successfully

success
boolean
required
message
string
required
data
object
required
verificationStatus
string
required
verificationStatusCode
integer
required
trustFlowId
integer
required
trustValidationId
string
required
verificationType
string
required
metadata
unknown
createdAt
string