Face Search Warnings and Errors

Our face search process includes automated checks to ensure high-quality results when searching for matching faces across previously verified identities. This page outlines the potential warnings and errors you might encounter during the face search process.

Verification Process

When performing face search, the system attempts to:

• Extract features from the submitted image
• Compare the extracted features against your database of verified faces
• Generate similarity scores for potential matches
• Apply configured thresholds to determine which matches to return

Automatic Decline Conditions

The following conditions will always result in an automatic failure regardless of application settings:

• NO_FACE_DETECTED - No face was detected in the search image
• NO_SESSIONS_TO_SEARCH - Your account has no previously approved verification sessions to search against

Configurable Verification Settings

Applications can configure how the system handles various search parameters:

1. Similarity Threshold

   • Configurable minimum similarity score (typically 70%)
   • Higher thresholds produce fewer, more accurate matches
   • Lower thresholds produce more potential matches but may include false positives

2. Allow Multiple Faces

   • Configurable to allow or disallow multiple faces in the search image. If disallowed, the session will fail if multiple faces are detected. If allowed, the session will return the highest largest face in the image.

Face Search Warnings

Warning Types

Warnings are categorized into three types based on severity: