Onfido logo home page
Watch a demo
Get in touch
Arrow back Back to guides

Document report

Start here

This guide presents a technical overview of Onfido's Document report.

Introduction

The Document report employs data integrity, visual authenticity and database record checks to verify identity documents such as passports, national ID cards and driver's licences. The report can also compare the data extracted from the document with data provided by the end user in other capture tasks or in the workflow input data, as an additional way of identifying potential discrepancies and fraudulent documents.

The majority of Document reports are automated and processed in seconds. If, however, Onfido encounters document images that use sophisticated counterfeiting techniques, or the capture is of poor quality (blurred, low resolution, obscured, cropped, or held at an unreadable angle), our software is supported by an expert manual review team to ensure an identity verification is subject to a thorough analysis in order to maximise fraud detection. Manual review can also be configured to be applied to all document verifications.

When document analysis falls back to manual review, the report results will be delivered asynchronously via webhook notifications. You can read more about webhooks in our API reference documentation.

During document capture, the Document report uses Near Field Communication (NFC) to validate the document's chip in order to verify the document. If NFC was successful, the visual authentication, image integrity and data consistency checks will not be performed. In addition, any data extracted from the document is returned in the properties attribute of the report. Please read our NFC for Document report guide for details on how to integrate and use NFC for Document reports.

The Document report breakdown tree

The results of Document reports are generated in the form of breakdowns and sub-breakdowns. A Document report can have an overall result of clear or consider.

The Document report uses the sub_result property to provide a more specific description of the overall report result. These sub-results and their meanings are described in the table below:

Sub-result
Clear If all underlying verifications pass.
Rejected If the report has returned information where the check cannot be processed further (for example, poor image quality or unsupported document).
Suspected The analysed document is suspected to be fraudulent.
Caution If any other underlying verifications fail, but they don't necessarily point to a fraudulent document (for example, the name provided by the applicant doesn't match the one on the document).

Breakdowns are made up of sub-breakdowns. A breakdown will have a consider result when at least one of its sub-breakdowns contains a consider or unidentified result.

Breakdowns and sub-breakdowns are mapped to particular sub-results. Certain mappings can be changed, depending on your configuration. You can use the Document report breakdown tree diagram below to understand the mapping of different sub-breakdowns and breakdowns to a sub-result, and the options for configuration. You can also read how individual breakdowns contribute to the overall sub_result value in the Document report in our API reference documentation.

Note: The following diagram illustrates the options available in v2 and v3 of the Onfido API.

Document report breakdown tree 1

The following diagram shows the reasons which can lead to specific sub-breakdowns and therefore sub-results other than clear in v2 and v3 of the Onfido API:

Document report breakdown tree 2

More details regarding the structure of the Document report and an example result can be found in our API reference documentation.

For how to proceed with an applicant based on the various results, you may find our guide on suggested client actions for the Document report useful.

Breakdown descriptions

Breakdown Sub-breakdown(s) Description
Age validation Minimum accepted age Asserts whether the age calculated from the document's date of birth data point is greater than or equal the minimum accepted age set at account level. The default minimum age is 16 years old but you can request to have this changed.
Data comparison Date of birth Indicates whether the information points extracted from the document match the information supplied when creating an applicant through the API.
Last name
First name
Data validation Date of birth Determines whether the data point is the expected length and format for this document type.
Document numbers
Machine Readable Zone (MRZ)
Gender
Expiry date
Document expiration Validates the expiry date extracted from a document, flagging if a document's expiry date has passed.
Barcode Validates the barcode against the defined standard for this document type. (Only available in v3.2 onwards)
Image integrity Conclusive document quality Measures the ability to make a fraud assessment based on the quality of the applicant's document. Applied by our expert manual review team when documents are unclassifiable as fraudulent or genuine.
Colour picture Flags if the image is black and white. This is because black and white documents prevent a full fraud assessment as the majority of security features are colour.
Image quality Flags if there is a low-resolution image where the document information is not readable, the MRZ (Machine Readable Zone) is obscured or unreadable or vital data points are obscured or unreadable.
Supported document Indicates whether the type of the submitted document is supported by Onfido and by the customer.
Video Document Presence Asserts whether there is at least a document with video and none of the documents has a video whose signature was checked and is invalid.
Data consistency Date of expiry Indicates whether data that appears in multiple places on the document, for example in the MRZ and printed on the front, is consistent in both places.
Document type
Nationality
Issuing country
Document numbers
Gender
First name
Last name
Date of birth
Multiple data sources present Acts as a validation for the `data_consistency` breakdown: if 2 sources are present, then data comparison is possible. (Only available in v3.1 onwards)
Visual authenticity Face detection Indicates whether a face was detected on the document.
Original Document Present (ODP) Indicates whether the provided image is an image of the original document or, for example, a photo of a photo of a document or a photo of a computer screen.
Fonts Indicates whether fonts in the document match the expected ones.
Picture face integrity Flags if the pictures of the person identified on the document show signs of tampering or alteration.
Digital tampering Flags when security features expected on the document are missing or wrong and are suspected to be tampered with digitally.
Security features Flags if security features expected on the document are missing or wrong.
Template Indicates whether the document matched the expected template for the document type and country it is from.
Other Flags when other sub-breakdowns under visual authenticity are flagged. Returned for backwards compatibility.
Compromised document Document Database Asserts whether the document is publicly available as compromised
Repeat Attempts Asserts whether the document has been reused in a suspicious way
Police record Indicates whether a document has been reported as lost, stolen or compromised to the UK Metropolitan Police
Issuing Authority NFC Passive Authentication Asserts whether the document's NFC chip data was tampered with. (Only available in v3.2 onwards)
NFC Active Authentication Asserts whether the document's NFC chip is original or cloned. (Only available in v3.2 onwards)

Document Report task

Similar to other Onfido reports, to run a Document report, a Document Report task should be added to a Studio workflow from the Workflow Builder.

When constructing a Studio workflow, a Document Report task must always follow the route of a Document Capture task in order to extract the appropriate input data. Input data for this task can also be received from the workflow input data, an Autofill task or a Profile Data Capture task.

Below you will find an illustrated example of a Studio workflow running a Document report:

Document report workflow

More information about report tasks can be found in our Studio Product Guide.

Document Report task results

If you wish to obtain the specific outputs from the Document Report task via the Onfido API (for example, the overall report result or breakdown results), you can manage this by configuring the Workflow Output in the Studio Workflow Builder. You can also retrieve all associated output data from a Document report.

You can refer to our Studio product guide for more information on Workflow Output configuration. Once set up, the output can be consumed by making a Retrieve Workflow Run call to the Onfido API. Report results are found in the output property.

Workflow Run results can also be accessed on the "Results" tab of your Studio Dashboard.

Document Video Report

Onfido offers a variation on the Document report, called a Document Video report, which ensures compliance with European Telecommunications Standards Institute (ETSI) regulations in relevant geographical areas.

Besides capturing a photo, our SDK records a 1.5-second video of an applicant's document, available for download via API or directly from your Dashboard. If a video isn't successfully recorded or there are signs that it was tampered with, the Document Video Report will be rejected, adhering to ETSI compliance requirements. In this instance, the Document Report's overall result will be consider due to image_integrity > video_document_presence being consider. In a Studio workflow, a negative video_document_presence returns a failed result.

Document Video Reports are compatible with our iOS (28.3.0 or higher), Android (16.3.0 or higher) and Web (12.2.1 or higher) SDKs.

For the Web SDK, customers must include the following configurations:

  • useLiveDocumentCapture option set to true (not applicable from version 10.2.0 onwards)
  • forceCrossDevice option set to true
  • uploadFallback option set to false (not applicable from version 13.0.0 onwards)

More details regarding the structure of the Document Video report and an example result can be found in our API reference documentation.

BETA Document reports

In addition to the Document report, Onfido offers the following BETA Document reports:

For more information about the features in these BETA reports, follow the links above to our API reference documentation, or contact your account manager.

Onfido

Our solutions

Onfido uses 256-bit SSL encryption 100% of the time on every device.

BSI ISO/IEC27001

Onfido has been certified by BSI to ISO 27001 under certificate number IS 660122.

© Onfido™, 2022. All rights reserved.
Company Registration Number: 07479524.