> ## 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. # Vocabulary > Reference iDenfy verification status codes, fraud tags, common identifiers like clientId and scanRef, and terminology definitions. ## Common Values | Value | Description | | ---------- | ------------------------------------------------------------ | | `clientId` | A unique string identifying a client on your side. | | `scanRef` | A unique string identifying a verification on iDenfy's side. | *** ## Overall Verification Statuses | Status | Description | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `APPROVED` | Verification successful — approved by automated platform or manual reviewer. | | `DENIED` | Verification unsuccessful — denied by automated platform or manual reviewer. | | `SUSPECTED` | Discrepancies found (e.g., mismatched data, duplicate face). If `autoFace`/`manualFace` is `FACE_MATCH` and `autoDocument`/`manualDocument` is `DOC_VALIDATED`, the verification passed but has flags. **You decide whether to approve.** Check `fraudTags` and `mismatchTags` for details. | | `REVIEWING` | A human reviewer is reviewing the verification. Contact support to toggle this feature. | | `EXPIRED` | Token expired and verification never took place. | | `ACTIVE` | Token is still active. The end user can use it to start verification. | | `EXPIRED-DELETED` | Token expired and verification data was deleted. | | `DELETED` | Verification data was deleted. | | `ARCHIVED` | Verification data was archived. | *** ## Face Status Values | Status | Description | | ------------------- | -------------------------------------------------------------------------------------------- | | `FACE_MATCH` | Selfie face matches the document photo. Person and document owner are the same. | | `FACE_MISMATCH` | Face could not be matched — features not fully visible, low quality, blur, shadow, or glare. | | `NO_FACE_FOUND` | Face cannot be accurately determined in the selfie. | | `TOO_MANY_FACES` | More than one face visible in the selfie. | | `FACE_TOO_BLURRY` | Selfie too blurry for face matching. | | `FACE_ERROR` | Unclassified error during face matching. | | `FACE_NOT_ANALYSED` | Verification denied for another reason — face analysis skipped. | | `FACE_NOT_CHECKED` | Selfie was not compared to the document face. | | `FAKE_FACE` | Photo not taken in real time, virtual camera detected, or face is fake. | | `FACE_GLARED` | Glare detected in selfie photo. | | `FACE_UNCERTAIN` | Face liveness cannot be determined — poor lighting, potential fake, or obstructions. | | `FACE_SUSPECTED` | Automatic algorithms suspect the selfie is not genuine. | | `FACE_BLACKLISTED` | Selfie matched an existing blacklist entry. | *** ## Document Status Values | Status | Description | | --------------------------- | ----------------------------------------------------------------------------- | | `DOC_VALIDATED` | Document is valid — all data visible, readable, and genuine. | | `DOC_NOT_FOUND` | No document found in the photo. | | `DOC_NOT_FULLY_VISIBLE` | Document or data not fully visible — blur, shadow, glare, fingers, or damage. | | `DOC_NOT_SUPPORTED` | Document type not supported for selected country or session. | | `DOC_FACE_NOT_FOUND` | Face could not be located on the document. | | `DOC_NAME_ERROR` | Name field could not be found or parsed. | | `DOC_SURNAME_ERROR` | Surname field could not be found or parsed. | | `DOC_EXPIRY_ERROR` | Expiry date field could not be found or parsed. | | `DOC_DOB_ERROR` | Date of birth field could not be found or parsed. | | `DOC_PERSONAL_NUMBER_ERROR` | Personal code could not be found or parsed. | | `DOC_NUMBER_ERROR` | Document number could not be found or parsed. | | `DOC_DATE_OF_ISSUE_ERROR` | Date of issue field could not be found or parsed. | | `DOC_SEX_ERROR` | Sex field could not be found or parsed. | | `DOC_NATIONALITY_ERROR` | Nationality field could not be found or parsed. | | `DOC_GLARED` | Document glared — data parsing cannot be performed. | | `DOC_FACE_GLARED` | Document face area is glared. | | `DOC_TOO_BLURRY` | Document too blurry for parsing. | | `DOC_NOT_ALLOWED` | Document readable but type not allowed in your settings. | | `DOC_EXPIRED` | Document has expired. | | `DOC_ERROR` | Unclassified error during document analysis. | | `DOC_NOT_ANALYSED` | Verification denied for another reason — document analysis skipped. | | `DOC_DAMAGED` | Document is physically damaged (cracked, broken). | | `DOC_FAKE` | Document detected as not genuine (virtual camera, photo of screen). | | `DOC_SPOOF_DETECTED` | Document detected as not real. | | `DOC_MOBILE_PHOTO` | Document shown from a mobile screen. | | `DOC_PRINT_SPOOFED` | Document appears to be printed on paper. | | `DOC_SIDE_MISMATCH` | Document side different than expected. | | `DOC_TYPE_MISMATCH` | Selected document type doesn't match the shown document. | | `DOC_FACE_BLACKLISTED` | Document face matched an existing blacklist entry. | | `DOC_PERSONAL_CODE_INVALID` | Personal code could not be verified. | | `DOC_INFO_MISMATCH` | Information provided doesn't match the document. | | `AUTO_UNVERIFIABLE` | Cannot be automatically verified — needs human review. | | `COUNTRY_NOT_SUPPORTED` | Document country not supported. | | `COUNTRY_MISMATCH` | Selected country and document issuing country don't match. | *** ## MRZ & Barcode Statuses | Status | Description | | ----------------------- | ------------------------------------------------------------ | | `MRZ_NOT_FOUND` | Machine Readable Zone could not be located. | | `MRZ_OCR_READING_ERROR` | Failed to read/parse MRZ — possible check-digit discrepancy. | | `MRZ_INVALID` | MRZ is invalid and cannot be verified. | | `BARCODE_NOT_FOUND` | Document barcode could not be located. | *** ## Fraud Tags | Tag | Description | | ------------------------------ | ----------------------------------------------------------------- | | `AML_SUSPECTION` | Client found in PEPs or Sanctions list (AML enabled). | | `AML_FAILED` | AML check failed (AML enabled). | | `LID_SUSPECTION` | Document found in lost/stolen documents database (LID enabled). | | `LID_FAILED` | LID check failed. | | `UNDER_AGE` | Client age below the configured age limit. | | `UNKNOWN_AGE` | Age could not be read and age limit is set. | | `FAKE_PHOTO` | General identifier for a fake photo. | | `VIRTUAL_CAMERA` | Virtual camera likely detected. | | `DEV_TOOLS_OPENED` | Client opened browser dev-tools during verification. | | `DUPLICATE_FACE` | Selfie matched with a previous verification. | | `DUPLICATE_DOC_FACE` | Document face matched with a previous verification. | | `DUPLICATE_PERSONAL_DATA` | Document data matched with a previous verification. | | `FACE_IN_BLACKLIST` | Face photo added to blacklist. | | `DOC_FACE_IN_BLACKLIST` | Document face added to blacklist. | | `DATA_BLACKLISTED` | Data matched against an existing blacklist entry. | | `DATA_IN_BLACKLIST` | Verification data used to create a blacklist entry. | | `PORTRAIT_SUBSTITUTION` | Document photo may have been replaced/substituted. | | `DOCUMENT_TOO_CLOSE_TO_BORDER` | Document image too close to frame border for liveness validation. | *** ## Mismatch Tags These appear when data provided during session creation doesn't match document data: | Tag | Description | | ----------------- | -------------------------------------- | | `NAME` | Client name doesn't match document. | | `SURNAME` | Client surname doesn't match document. | | `FULL_NAME` | Full name doesn't match document. | | `DOCUMENT_NUMBER` | Document number doesn't match. | | `PERSONAL_CODE` | Personal code doesn't match. | | `EXPIRY_DATE` | Expiry date doesn't match. | | `DATE_OF_BIRTH` | Date of birth doesn't match. | | `DATE_OF_ISSUE` | Date of issue doesn't match. | *** ## Additional Step Statuses | Status | Description | | -------------------------------------- | ---------------------------------------------------------------- | | `INVALID_ADDITIONAL_STEP` | Additional step document was invalid. | | `ADDITIONAL_STEP_NOT_FOUND` | Additional step was not found. | | `ADDITIONAL_STEP_INFORMATION_MISMATCH` | Additional step data doesn't match the document. | | `EXPIRED_ADDITIONAL_STEP_INFORMATION` | The provided additional document has expired. | | `ADDRESS_UNVERIFIED` | Address verification not performed or address not matched/found. |