Documentation Index
Fetch the complete documentation index at: https://documentation.idenfy.com/llms.txt
Use this file to discover all available pages before exploring further.
This guide details the specific feedback messages your customers receive during the verification process. It covers the general status screens (Success, Failed, Suspected) and the specific error codes returned when a document or face check fails.
General Status Screens
These are the primary messages displayed to your user at the end of a verification session.
| Status | User Message (Title / Subtitle) | Meaning |
|---|
| Success | **“Verification successful”**Your identity has been confirmed. | The user passed all checks. |
| (This is the standard message when no issues are found). | | |
| Failed | **“Your verification was unsuccessful”**Unfortunately, we could not confirm your identity. Something went wrong. | The verification was denied due to a critical error or policy violation. |
| ** Suspected** | **“Thank you. Verification may be further investigated.”**Your information has been submitted. Some discrepancies were identified. | The system flagged potential issues. The session is likely sent for manual review. |
| ** Unverified** | **“Verification time expired”**The verification process was not performed within the allocated time. | The user abandoned the session or the time limit ran out. |
Face Denial Reasons
These errors occur during the selfie capture or liveness check.
| Error Tag | Message to User / Description |
|---|
| FAKE_FACE | The face appears covered, not visible, or spoofed. |
| FACE_TOO_BLURRY | The face appears too blurry. Device may be shaking. |
| FACE_MISMATCH | Mismatch between the selfie and the document photo. |
| NO_FACE_FOUND | Face could not be found in the selfie. |
| TOO_MANY_FACES | More than one face was detected in the photo. |
| AUTO_UNVERIFIABLE | Automatic verification of face was not possible. |
Document Denial Reasons
These errors occur during document analysis. They are grouped by category for easier debugging.
Visibility & Image Quality
| Error Tag | Message to User / Description |
|---|
| DOC_NOT_FOUND | Cannot find the document in the photo provided. |
| DOC_NOT_FULLY_VISIBLE | Parts of the document are hidden or cut off. |
| DOC_TOO_BLURRY | Document is too blurry to read (focus/lighting issue). |
| DOC_GLARED | Too much glare/reflection on the document. |
| DOC_FACE_GLARED | Too much glare specifically on the face photo. |
| DOC_FACE_NOT_FOUND | Face photo could not be located on the document. |
| DOC_DAMAGED | Document appears physically damaged. |
Data Mismatches & Validity
| Error Tag | Message to User / Description |
|---|
| DOC_INFO_MISMATCH | Information from document does not match client input. |
| DOC_EXPIRED | The document is expired and cannot be used. |
| DOC_SPOOF_DETECTED | Potential spoof or fake detected. |
| DOC_FAKE | Issue reading document authenticity (suspected fake). |
| DOC_PERSONAL_CODE_INVALID | Personal code found but could not be verified/invalid format. |
User Selection Errors
| Error Tag | Message to User / Description |
|---|
| DOC_TYPE_MISMATCH | Uploaded document does not match selected type (e.g. Passport vs DL). |
| DOC_SUBTYPE_MISMATCH | Issue recognizing the specific document subtype. |
| DOC_SIDE_MISMATCH | Provided side does not match (e.g. Front instead of Back). |
| COUNTRY_MISMATCH | Document country does not match selected country. |
| DOC_NOT_SUPPORTED | Document type is not supported. |
| DOC_NOT_ALLOWED | Document type is valid but not allowed by your configuration. |
| COUNTRY_NOT_SUPPORTED | The specified country is not supported. |
| Error Tag | Message to User / Description |
|---|
| DOC_NAME_ERROR | Name not found or differs too much from input. |
| DOC_SURNAME_ERROR | Surname not found or differs too much from input. |
| DOC_EXPIRY_ERROR | Unable to find expiry date. |
| DOC_DOB_ERROR | Unable to find date of birth. |
| DOC_PERSONAL_NUMBER_ERROR | Unable to find personal code. |
| DOC_NUMBER_ERROR | Unable to find document number. |
| DOC_DATE_OF_ISSUE_ERROR | Date of issue could not be read. |
| DOC_SEX_ERROR | Sex/Gender could not be read. |
| DOC_NATIONALITY_ERROR | Nationality could not be read. |
Technical Reading Errors (MRZ, Barcode, NFC)
| Error Tag | Message to User / Description |
|---|
| MRZ_NOT_FOUND | Machine Readable Zone (MRZ) area cannot be located. |
| MRZ_INVALID | MRZ code appears to be invalid. |
| MRZ_OCR_READING_ERROR | Trouble reading the MRZ text characters. |
| BARCODE_NOT_FOUND | Barcode could not be located. |
| NFC_FAILED | Issue reading the document NFC chip. |
| NFC_INIT_FAILED | Could not initialize NFC reading. |
| NFC_TIMEOUT | NFC reading timed out. |
System Errors
| Error Tag | Message to User / Description |
|---|
| DOC_ERROR | An error occurred while analyzing the document. |
| DOC_NOT_ANALYSED | The document was not analyzed. |
