Search (1:N)

search answers “who is this?” — it matches the captured finger against the enrolled population and returns the single best enrollee. Read the consent and law note before enabling 1:N.

val session = sdk.createFingerprintReaderSession(reader.id)
 
val result = session.search(position = 2)
when {
    result == null   -> { /* handled failure — see session.errors */ }
    result.matched   -> identify(result.enrollee, result.similarity)
    else             -> noMatch()   // matched=false, enrollee=null is normal
}

Reading SearchResult

• matched: Boolean — whether a candidate cleared the match threshold.
• enrollee: String? — the best-matching enrollee id (null on no match).
• similarity: Double? / matchScore: Double? — the ranking signals for the top candidate.

search returns one best result, not a ranked list. If a candidate clears threshold you get their enrollee; otherwise matched = false.

Notes

• position defaults to 0 (unspecified). Pass the expected finger position when you know it — it lets the server scope the search.
• 1:N accuracy depends on corpus size and capture quality; benchmark for your population.

Used in

• Enroll, verify, identify