Skip to main content
🤳

Face Verification

Compare two facial images and confirm a customer is who they claim to be. The endpoint returns a similarity score, image quality rating, and a passive liveness check result — all in a single call.

📊 Similarity score🖼️ Image quality rating👁️ Passive liveness check📎 multipart/form-data

How to Use It​

Send two images as multipart/form-data fields — a reference image and a comparison image. The typical use case is confirming that a customer's live photo matches the face on their BVN record.

Request fields — multipart/form-data

referenceImage
From BVN — data.face_image
The customer's face image from their BVN record. Returned as a base64 string by Fetch BVN Details — pass it here as a file upload.
comparisonImage
Live capture
A photo of the customer taken at the point of onboarding (e.g. selfie or camera frame). This is the image being compared against the reference.
Send as multipart/form-data — not JSON

Both image fields must be uploaded as file fields in a multipart/form-data request. Sending them as base64 strings in a JSON body will not work.

Bearer token required

This endpoint requires a valid Bearer token. Obtain one from the Access Token endpoint and pass it as Authorization: Bearer <token>.

Get the reference image from BVN

The data.face_image field returned by Fetch BVN Details is the base64-encoded face from the customer's BVN record. Use it as the referenceImage for the most accurate comparison.

Endpoint​