Verification Statuses

This page defines every value a verification can return. If you’d rather see where a value comes from than read it in a table, the playground below puts each one back in context — configure a verification and watch which status, document and face results, and tags it returns.

Status & Tag Playground

Configure a verification, then watch the statuses and tags it produces, the webhook your server receives, and what each tag costs the user. A presentation, not a live account — nothing here calls iDenfy. Opens in a new tab.

Overall Status

Status	Meaning
APPROVED	Automated and manual checks were successful. Check `autoFace`, `manualFace`, `autoDocument`, `manualDocument` for details. Typical success: `FACE_MATCH` + `DOC_VALIDATED`.
DENIED	Verification failed. Check detailed statuses for the reason (e.g., `FACE_MISMATCH`, `DOC_NOT_FOUND`).
SUSPECTED	Checks may have passed, but discrepancies were found — flagged with `fraudTags` or `mismatchTags`. You decide whether to approve or deny.
REVIEWING	A human reviewer is currently checking the verification. Contact support to toggle this feature.
EXPIRED	The verification token was never used and has expired.
ACTIVE	The token has been created but not yet used.
EXPIRED-DELETED	Token expired and data was deleted.
DELETED	Verification data has been deleted.
ARCHIVED	Verification data was archived.

APPROVED and DENIED are explained by the detailed statuses on the autoFace, manualFace, autoDocument, and manualDocument fields below, and SUSPECTED by the fraudTags/mismatchTags below. For what to do with each status in your integration, see Status Handling.

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.

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.

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_SIDE_MISMATCH`	Document side different than expected.
`DOC_TYPE_MISMATCH`	Selected document type doesn’t match the shown document.
`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.
`NFC_FAILED`	NFC read/authentication failed.
`NFC_TIMEOUT`	Client didn’t finish NFC read in time.
`EID_FAILED`	E-ID (electronic ID) capture was not taken successfully.

MRZ and 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.
`CRIMINAL_SUSPECTED`	Criminal check found a hit that needs to be reviewed.
`CRIMINAL_CHECK_FAILED`	Criminal check was not initiated successfully and needs to be initiated manually.
`DL_FAILED`	The DMV database is currently unavailable, try again later.
`RC_FAILED`	Failed to check registry center (RC) data.
`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.
`DOC_FACE_BLACKLISTED`	Document face matched an existing blacklist entry.
`FACE_SUSPECTED`	Automatic algorithms suspect the selfie is not genuine.
`FACE_BLACKLISTED`	Selfie matched an existing blacklist entry.
`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.
`DOC_MOBILE_PHOTO`	Document shown from a mobile screen.
`DOC_PRINT_SPOOFED`	Document appears to be printed on paper.

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.
`NATIONALITY`	Nationality provided doesn’t match document.
`SEX`	Sex provided doesn’t match document.
`DOC_INFO_MISMATCH`	Information provided doesn’t match the document.
`UNDER_AGE`	Client age below the configured minimum age limit.
`OVER_AGE`	Client age above the configured maximum age limit.
`UNKNOWN_AGE`	Age could not be read and an age limit is configured.
`UTILITY_ADDRESS`	Address on utility bill doesn’t match provided address.
`UTILITY_NAME`	Name on utility bill doesn’t match provided name.
`EXPIRED_UTILITY_BILL`	Utility bill has expired.
`REGISTRY_CENTER_INFO_MISMATCH`	Registry center data doesn’t match provided information.
`DRIVER_LICENSE_INFO_MISMATCH`	Driver’s license data doesn’t match provided information.

Don’t see a fraudTags or mismatchTags value explaining a SUSPECTED result? Contact support via our ticketing portal.

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.
`NOT_SUPPORTED_POA_DOCUMENT_TYPE`	Proof of address document type not supported.
`NOT_SUPPORTED_POA_DOCUMENT_COUNTRY`	Proof of address document country not supported.
`POA_COUNTRIES_MISMATCH`	Proof of address country doesn’t match the expected country.
`POA_SCREENSHOT_DETECTED`	Proof of address document appears to be a screenshot.

General

Billing

Dashboard Settings

ID Verification

Business Verification

AML Screening

Age Estimation

Risk & Fraud

Other Services

Status & Tag Playground

Overall Status

Common Values

Face Status Values

Document Status Values

MRZ and Barcode Statuses

Fraud Tags

Mismatch Tags

Additional Step Statuses

Status & Tag Playground

​Overall Status

​Common Values

​Face Status Values

​Document Status Values

​MRZ and Barcode Statuses

​Fraud Tags

​Mismatch Tags

​Additional Step Statuses

Overall Status

Common Values

Face Status Values

Document Status Values

MRZ and Barcode Statuses

Fraud Tags

Mismatch Tags

Additional Step Statuses