Skip to main content

Face Compare

Authentication

This endpoint requires a Bearer token. Obtain one first from the Get Access Token endpoint, then pass it as Authorization: Bearer <token>.

Compares two facial images and returns a similarity score, image quality rating, and passive liveness check results.

Typical usage
  • referenceImage — the customer's face image from their BVN record (returned as data.face_image by Fetch BVN Details)
  • comparisonImage — a live capture of the customer at the point of onboarding

This endpoint accepts multipart/form-data — send both fields as file uploads, not JSON.

Loading API reference…