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 | Verification is being reviewed by a human. Contact support to toggle this feature. |
EXPIRED | Token expired and verification never took place. |
ACTIVE | Token is still active and can be used by the client. |
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 token generation 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. |