> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pearcheck.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Warning Codes

For every user verification, we run a series of validations. One or more warnings may be generated if the validation fails to pass.

### Document and OCR Warnings

| Warning Code | Description | Decision |
| :- | :- | :- |
| UNRECOGNIZED\_DOCUMENT | Document not recognized. | REVIEW |
| UNREADABLE\_DOCUMENT | Document not readable. | REVIEW |
| DOCUMENT\_NOT\_FOUND | Document is not found in the uploaded image. | DECLINED |
| DOCUMENT\_EXPIRED | Document is expired. | DECLINED |
| DOCUMENT\_FRONT\_BACK\_MISMATCH | Document front and back does not belong to same person. | REVIEW |
| DOCUMENT\_DAMAGED | The document is damaged. | REVIEW |
| DOCUMENT\_FRONT\_MISSING | Document front not detected in the document image. | DECLINED |
| DOCUMENT\_BACK\_MISSING | Document back not detected in the document image. | DECLINED |
| DOCUMENT\_FRONT\_OR\_BACK\_MISSING | Document front or back is missing or cannot be read. | DECLINED |
| DOCUMENT\_CROPPED | Document not fully in frame / cropped. | REVIEW |
| DOCUMENT\_FACE\_NOT\_FOUND | Could not detect face in document image. | REVIEW |
| DOCUMENT\_TOO\_FAR | The document is too far from the camera. | APPROVED |
| DOCUMENT\_TAMPERED | Document patterns hint at tampering or recreation. | REVIEW |
| AGE\_UNDER\_18 | User is under 18 years old. | REVIEW |
| INVALID\_DOCUMENT\_DETAILS | Document data is invalid or not as per the standards. | REVIEW |
| ID\_PREVIOUSLY\_SEEN | The given identity document/number has been previously verified. | APPROVED |
| DATABASE\_LOOKUP\_ISSUE | The data could not be verified with a third-party/government database. | REVIEW |
| MRZ\_DATA\_MISMATCH | Data from MRZ / Barcode / QR code does not match with the extracted data | APPROVED |

### Document - Missing Fields

| Warning Code | Description | Decision |
| :- | :- | :- |
| MISSING\_EXPIRY\_DATE | Document expiry date is missing or cannot be read. | REVIEW |
| MISSING\_ISSUE\_DATE | Document issue date is missing or cannot be read. | REVIEW |
| MISSING\_BIRTH\_DATE | Birthday information is missing or cannot be read. | APPROVED |
| MISSING\_DOCUMENT\_NUMBER | Document number is missing or cannot be read. | REVIEW |
| MISSING\_PERSONAL\_NUMBER | Personal number or national ID number is missing or cannot be read. | APPROVED |
| MISSING\_ADDRESS | Address is missing or cannot be read. | APPROVED |
| MISSING\_POSTCODE | Postcode is missing or cannot be read. | APPROVED |
| MISSING\_NAME | Given name or family name is missing or cannot be read. | REVIEW |
| MISSING\_GENDER | Gender is missing or cannot be read | APPROVED |
| MISSING\_NATIONALITY | Nationality is missing or cannot be read. | APPROVED |
| MISSING\_DOCUMENT\_DETAILS | Document data is missing or cannot be read. | APPROVED |

### Document - Mismatch between supplied fields and extracted/lookup data.

| Warning Code | Description | Decision |
| :- | :- | :- |
| NAME\_VERIFICATION\_FAILED | Mismatch between supplied user name and extracted/looked up name. | APPROVED |
| BIRTH\_DATE\_MISMATCH | Mismatch between supplied birthday and extracted/looked up birthday. | APPROVED |
| ID\_DATA\_MISMATCH | Mismatch between supplied user data and data from third-party/government database. | APPROVED |
| ID\_TYPE\_MISMATCH | The ID type does not match with the input identity type. | APPROVED |
| ID\_COUNTRY\_MISMATCH | The ID issue country does not match with the input country. | DECLINED |
| ADDRESS\_MISMATCH | Mismatch between supplied address and extracted/looked up address. | APPROVED |
| ID\_NOT\_ALLOWED | Identity type is not enabled in the template. | APPROVED |
| EMAIL\_ADDRESS\_MISMATCH | Mismatch between supplied email address and extracted/looked up email address. | APPROVED |
| PHONE\_NUMBER\_MISMATCH | Mismatch between supplied phone number and extracted/looked up phone number. | APPROVED |

### Document Anti-forgery Warnings.

| Warning Code | Description | Decision |
| :- | :- | :- |
| DOCUMENT\_PHOTO\_OF\_PHOTO | Document appears to be a photo of a photo. | REVIEW |
| SCREEN\_DETECTED | The document image contains a screen, monitor or mobile device therefore is possibly a photo of a photo | REVIEW |
| IMAGE\_FORGED\_EDITED | The document image possibly contains forged elements which warrants a manual review or rejection. | REVIEW |
| FEATURE\_VERIFICATION\_FAILED | Document features does not match with official document, the document could be fake, blurry or low resolution. | REVIEW |
| FAKE\_ID | The document uploaded is a fake or sample document, not an authentic document. | REVIEW |
| DOCUMENT\_FOUND\_ON\_INTERNET | The document image is found on the internet. | REVIEW |
| ARTIFICIAL\_IMAGE | Document appears to be created artificially, not a naturally taken photo. | REVIEW |
| ARTIFICIAL\_TEXT | Most texts within the image appears to be created artificially. | REVIEW |
| TEXT\_FORGERY | Possible artificial text modification detected. | REVIEW |
| IMAGE\_TOO\_SMALL | The image resolution did not meet the standards. | REVIEW |
| GLARE\_DETECTED | The document image contains possible glare. | REVIEW |
| IMAGE\_TOO\_BLURRY | The document image is blurry. | REVIEW |
| CHECK\_DIGIT\_FAILED | The document is not a valid document because it contains invalid check dig | REVIEW |
| PRINTOUT\_DETECTED | The document image is a print out / photocopy of the original. | REVIEW |
| BLACK\_WHITE\_DOCUMENT | The document appears to be black & white photocopy. | REVIEW |

### Biometric Warnings

| Warning Code | Description | Decision |
| :- | :- | :- |
| FACE\_NOT\_FOUND | Could not detect face in selfie image. | DECLINED |
| MULTIPLE\_FACES | Multiple faces detected in selfie image. | DECLINED |
| FACE\_MISMATCH | Face mismatch between document/government photo and selfie photo. | DECLINED |
| LOW\_FACE\_SIMILARITY | Low face similarity between document/government photo and selfie photo. | REVIEW |
| FACE\_IDENTICAL | Selfie photo appears to be the exact same photo as document photo. | REVIEW |
| FACE\_NOT\_LIVE | Selfie photo is not live. | DECLINED |
| FACE\_PHOTO\_OF\_PHOTO | Selfie photo appears to be a photo of a photo. | DECLINED |
| FACE\_COVERED | Selfie photo appears to have hat or mask or glasses. | DECLINED |
| FACE\_EDITED | Selfie photo edited using filters. | DECLINED |
| FACE\_BLUR | Selfie photo is too blurry and should be retaken for improved accuracy. | DECLINED |
| FACE\_TOO\_CLOSE | Selfie photo is too close to the camera. | DECLINED |
| FACE\_CROPPED | Selfie photo cropped / not completely visible. | DECLINED |
| FACE\_TOO\_SMALL | The relative proportion of face size in the image is too low. | DECLINED |
| FACE\_ANGLE\_TOO\_LARGE | Facial out-of-plane rotation angle is extremely large. | DECLINED |
| FACE\_LIVENESS\_REVIEW\_REQUIRED | Selfie photo liveness manual review required. | REVIEW |
| FACE\_DEEPFAKE | Selfie photo appears to be a deepfake | REVIEW |
| SELFIE\_VIDEO\_FRAUD | Selfie video appears to be fraudulent. | DECLINED |
| FACE\_AGE\_MISMATCH | Given age doesn't match with age predicated via facial analysis. | APPROVED |
| FACE\_LIVENESS\_TOO\_FAR\_FROM\_CAMERA | Face is too far from the camera. | REVIEW |

### ID Number Warnings

| Warning Code | Description | Decision |
| :- | :- | :- |
| ID\_NUMBER\_NOT\_VERIFIED | The given identity number could not be verified against a database. | DECLINED |
| INVALID\_ID\_NUMBER\_SUPPLIED | The given identity number is not in correct format. | DECLINED |
| LOOKUP\_SOURCE\_DOWN | The government/third-party lookup source is not available. | DECLINED |
| LOOKUP\_FACE\_NOT\_FOUND | Could not find face image in government/third-party database. | DECLINED |

### AML/PEP Warnings

| Warning Code | Description | Decision |
| :- | :- | :- |
| AML\_MATCH | Potential match from AML database. | REVIEW |

### Fraud Warnings

| Warning Code | Description | Decision |
| :- | :- | :- |
| GEOLOCATION\_MISMATCH | The ID issue country does not match with the geolocation country of user. | REVIEW |
| SUSPICIOUS\_USER\_BEHAVIOUR | Detected suspicious user behaviour. | REVIEW |
| IP\_ADDRESS\_SUSPICIOUS | Client request originated from a suspicious IP address. | REVIEW |
| TOR\_DETECTED | User is using TOR or on the TOR network. | APPROVED |
| VPN\_DETECTED | User is using VPN. | APPROVED |
| BOT\_DETECTED | User is using BOTs to complete the request. | APPROVED |
| BROWSER\_PREVIOUSLY\_ATTEMPTED | Multiple requests attempted from the same browser. | APPROVED |
| IP\_ADDRESS\_PREVIOUSLY\_ATTEMPTED | Multiple attempts detected from the same IP address. | APPROVED |
| ID\_PREVIOUSLY\_ATTEMPTED | Multiple attempts detected using the same ID document / number. | APPROVED |
| FACE\_PREVIOUSLY\_ONBOARDED | Person (Face Image) has attempted to onboard before. | APPROVED |
| PRIVACY\_SETTINGS\_BLOCKED | Can't get geolocation of user, privacy settings blocked the request. | APPROVED |

### Phone & Email Warnings

| Warning Code | Description | Decision |
| :- | :- | :- |
| EMAIL\_NOT\_FOUND | No email address found. | DECLINED |
| PHONE\_NUMBER\_NOT\_FOUND | No phone number found. | DECLINED |

### Background check

| Warning Code | Description | Decision |
| :- | :- | :- |
| BACKGROUND\_CHECK\_ALERT | Background search completed and records were found. | REVIEW |

### Generic Error Code

| Warning Code | Description | Decision |
| :- | :- | :- |
| CUSTOM\_ERROR\_CODE | In this case, a custom error message is returned explaining more details about the warning. This is used in case a warning happened which is not one of the above. | REVIEW |
| API\_DATA\_REQUIREMENTS\_NOT\_MET | Missing required fields to run the API. | UNKNOWN |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.