Skip to main content
Once a Face Match session is complete, call /verify-face to get the user’s Decision, Risk Score, and Risk Flags. See Response Signals for how to interpret everything the endpoint returns. If you passed an account_id when creating the session, the response also includes account context:
  • lists — names of the lists the account is currently a member of. If the account is on an allow list, decision is Real; on a block list, Fake.
  • rules — names of rules that have triggered for this account.
Both fields are empty arrays ([]) for sessions not linked to an account. See Rules, Lists, and Verifications for details.
To link an account_id to a session that has already completed, use the Enroll endpoint.
For strict 1:1 sign-in authentication (matching a returning user against their own enrolled face), see Authentication, which uses the /verify-identity endpoint.

​
API Reference

For complete details on all available endpoints and parameters, see the Face Match API Reference.