Skip to main content
The Document Verification module consolidates Document Classification, Document Extraction, and Document Authentication into a single module. Rather than placing three separate modules in a journey, this module performs all three checks in one step. The module returns the combined classification result, extracted fields, image quality checks, and authentication and tamper results. It is available in the US, EU, and AU regions. The module takes the following inputs and returns the following outputs:
  • Required inputs: Primary document front side image.
  • Optional inputs: Primary document back side image.
  • Outputs: Document classification, extracted document data, anchor portrait image, and document validation results.

Capabilities

The module returns capabilities grouped into four areas: classification, image quality, extraction, and authentication.

Classification capabilities

Classification identifies the document and returns its type and issuing origin. The module returns the following classification values:

Image quality checks

The module runs image quality checks on both the front and back sides of the document. Each check returns one of five values:

Front side checks

The following checks run on the front side image of the document:

Back side checks

The following checks run on the back side image of the document, when a back image is provided:

Extraction capabilities

Extraction reads the required fields from the document and derives related values, such as the subject’s age and expiry status. The module returns the following extraction values:

Authentication capabilities

Authentication assesses whether the document is genuine and whether it shows signs of tampering. The module returns the following authentication values:

Default outcomes

The outcome logic spans all three phases. Classification outcomes are evaluated first, then authentication/tamper risk outcomes, then extraction outcomes.

Input payload

The following is a sample payload used to submit document images to the Document Verification module for processing.
JSON

Sample response

The following is a sample response from the Document Verification module.
JSON

Document Verification

Document Verification consolidates Document Classification, Document Extraction, and Document Authentication into a single module dispatch. The single module returns the combined classification result, extracted fields, and authentication/tamper checks in one journey segment.

Capabilities

Default outcomes

The following default outcomes are available for evaluation and routing in the Journey builder.

Input payload

The following is a sample payload used to submit data to the Document Verification module for processing.
JSON

Sample response

The following is a sample response returned by the module.
JSON

Document tampering result

Returns the result for document tampering.

Document authentication result

Returns the result of the document authentication.

Anchor image extracted

Indicates whether the anchor (portrait) image was successfully extracted from the document. When false, downstream facematch can be skipped as there is no anchor image to compare against.

Days since expiry

Provides the number of whole days since the document’s Expiry Date. Returns 0 when the document has not expired, or when the Expiry Date could not be determined. Important: when authoring a threshold rule, always combine this with Document Expiry Status = Expired, because Not Expired and Undeterminable documents also return 0 — a rule on Days Since Expiry alone (for example, <= 730) would match those too. Example: ‘Document Expiry Status is Expired AND Days Since Expiry <= 730’ accepts only documents that expired within a 730-day / ~2-year grace period.

Calculated age

Provides a calculated Age (in years) based on date of birth and current date.

Document expiry status

Provides the document’s Expiry status.

Document extraction result

Provides an extraction result based on the customer’s required extraction data (as defined in configuration).

Back side full document in view check

Returns Back Side Full Document In View Check result

Front side full document in view check

Returns Front Side Full Document In View Check result

Back side colour check

Returns Back Side Colour Check result

Front side colour check

Returns Front Side Colour Check result

Back side blur check

Returns Back Side Blur Check result

Front side blur check

Returns Front Side Blur Check result

Back side glare check

Returns Back Side Glare Check result

Front side glare check

Returns Front Side Glare Check result

Back side low resolution check

Returns Back Side Low Resolution Check result

Front side low resolution check

Returns Front Side Low Resolution Check result

Country name

Returns the full country name

Document country code

Returns the country code in ISO3 format, eg. GBR.

State name

Returns the state name if applicable.

Document type

Returns the type of document, for example: Passport, Identification Card, etc.

Document classification result

Overall Classification Result for Classification Module The following guides and tutorials use this module or explain how to configure it.

Identity document verification

Verify a customer’s identity document.

How to combine document and biometric modules

Ordering documents and biometrics.