Skip to main content
Every verification with a face step runs more than one biometric analysis, and they are easy to confuse. Face matching compares faces. Liveness detection does not compare anything — it decides whether the captured subject is a genuine, physically present human. This page explains each check, which result field reports it, and what biometric data iDenfy stores as a consequence.

The Three Checks at a Glance


1:1 Face Matching

The face is extracted from the portrait on the submitted identity document and compared against the face captured during the verification session. Only these two images are involved, and both come from the same session — hence one-to-one. The outcome is reported on autoFace (and on manualFace if the verification goes to human review):
  • FACE_MATCH — the person and the document owner are the same.
  • FACE_MISMATCH — the faces could not be matched.
  • Quality codes such as NO_FACE_FOUND, TOO_MANY_FACES, or FACE_TOO_BLURRY mean the comparison could not be completed reliably.
For every possible value and its plain-English meaning, see Verification Statuses → Face Status Values.

1:N Face Matching

The session’s face data — the selfie, the face on the document, or both — is compared against biometric templates already stored for your account. This is one-to-many: one new face against many stored records. Its purpose is to recognize a returning person, not to validate the current document. Two features rely on it: A hit does not deny the verification — the submitted data is still valid, so the result becomes Approved (Suspected) with the tag attached, and you decide whether to onboard the user. See Suspected Status.
1:N matching only works if there is something to match against, so enabling either feature is what causes biometric templates to be retained for your account. See What Biometric Data Is Stored.

Liveness Detection Is Not Face Matching

Liveness detection is not a face comparison — neither 1:1 nor 1:N. It is a distinct analysis of a single capture, designed to determine whether the subject is a genuine, live human or a spoof attempt.
Because the two checks answer unrelated questions, they can disagree — and each can fail while the other passes: A perfect face match therefore proves nothing about presence, which is why liveness is configured and evaluated separately. For the detection methods, spoofing categories, and configuration options, see Liveness Checks.

What Biometric Data Is Stored

The only biometric artifact iDenfy can retain is a facemap — a mathematical template derived from a face image, not the image itself. A facemap is stored only when your account uses a feature that needs a reference set to match against:
  • Duplicate Check — selfie, document face, or both
  • Face Blocklist — selfie, document face, or both
  • Face Authentication — re-authenticates a returning user against the template from their original verification
If you do not use any of these features, no biometric markers are saved. The faces are compared during the session to produce the 1:1 result, and no biometric template is derived or retained afterwards.
Biometric template retention is a separate question from document and image retention. Captured images and extracted data follow the data retention period configured for your account, regardless of whether any facemap is stored. For legal bases, special-category obligations, and retention configuration, see GDPR Compliance.

Next Steps

Liveness Checks

Detection methods, spoofing types, and configuration.

Duplicate Check

Detect the same person registering more than once.

Blocklist Setup

Block known fraudsters by face, document, or personal data.

GDPR Compliance

Legal bases and retention for biometric processing.