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 imageFACE_IN_BLOCKLIST
- The face matches an entry in your face blocklist
Configurable Verification Settings
Applications can configure how the system handles various search parameters:
-
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
-
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
Tag | Description |
---|---|
NO_FACE_DETECTED | No face could be detected in the provided search image. |
MULTIPLE_FACES_DETECTED | Multiple faces were detected in the provided search image, making it unclear which face to search for. |
FACE_IN_BLOCKLIST | The face has been identified as matching an entry in your face blocklist. This occurs when the biometric data matches a previously blocklisted individual. |
Warning Types
Warnings are categorized into three types based on severity:
Type | Description |
---|---|
ERROR | Critical issues that resulted in setting the session to 'Declined' |
WARNING | Issues that require attention that resulted in setting the session to 'In Review' |
INFORMATION | Informational messages that don't affect verification outcome |