Didit Face Search API (1:N)

Overview

Searches the largest face in an image against your application's face search index and returns up to 5 ranked matches above the similarity floor, plus blocklist and duplicate warnings.

What is searched: faces enrolled from verification sessions of any status, saved standalone calls (e.g. Passive Liveness or Age Estimation with save_api_request=true), faces uploaded directly to User profiles, faces on your lists (blocklist, allowlist), and image-free biometric templates you chose to retain on a User. Faces enrolled by earlier Face Search calls are never returned, so repeated searches do not match each other.

Search modes (search_type):

• most_similar (default): ranks every enrolled face by similarity. Use for deduplication and fraud-ring investigation.
• blocklisted_or_approved: only blocklisted faces, allowlisted faces, faces from approved sessions, imported User faces and retained templates, with blocklisted entries ranked first. Use for blocklist screening.

Key constraints:

• Allowed file extensions: tiff, jpg, jpeg, png, webp (no PDF)
• Maximum file size: 5 MB (images are compressed to about 0.5 MB before processing)
• The image must contain a detectable face, otherwise HTTP 400 {"error": "No face detected in the image"}
• With several faces the largest one is searched and MULTIPLE_FACES_DETECTED is added
• vendor_data does not exclude the same user's earlier faces from the results (unlike Passive Liveness)