Document report
Start here
This is an introductory guide and overview for the Document report.
You'll find API documentation separately.
Introduction
The Document report is composed of data integrity, visual authenticity and police record checks. It checks the internal and external consistency of the identity document provided by the applicant to identify potential discrepancies.
If available, the Document report uses Near Field Communication (NFC) to validate the document's chip in order to verify the document. In this case, the visual authentication, image integrity and data consistency checks will not be performed. Please read our NFC for Document report guide for details on how to integrate and use NFC for Document reports.
In addition, any data extracted from the document is returned in the properties
attribute.
The Document report combines software and an expert team to maximise fraud detection. The majority of documents will be processed instantly. However, when document analysis falls back to expert review, the report status will be delivered asynchronously via webhook notifications. You can read about webhooks in our API documentation.
Expert review is required when we encounter images that use sophisticated counterfeiting techniques, or the image is of poor quality (blurred, low resolution, obscured, cropped, or held at an unreadable angle).
The Document report breakdown tree
The Document report uniquely uses the sub_result
field in the API response
to give a more detailed description than the result
:
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, where possible, depending on your configuration.
You can use the Document report breakdown tree diagram 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
documentation.
Note: The following diagram illustrates the options available in API v2 and v3.
The following diagram shows the reasons which can lead to specific sub-breakdowns and therefore sub-results other than 'Clear' in API v2 and v3:
You may find our guide on "suggested client actions" for the Document report useful.
BETA Document reports
Almost all use cases will require the 'primary' Document report, but yours may require one of the following BETA Document reports:
- Document with Address Information
- Document with Driving Licence Information
Contact your account manager for more information about the features in these BETA reports.
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 | Determines whether Onfido currently supports that type of document. | |
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 | Indicates whether the document has been recorded as either stolen, lost or the individual has been a victim of identity fraud. Additionally, this breakdown can also indicate that the document was either taken from the internet or has been exposed publicly on the internet |
Repeat Attempts | Asserts whether the document has been reused in a suspicious way | |
Police record | Indicates whether a document has been lost, stolen or compromised | |
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) |