> ## 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  |
