Facial verification
Face Liveness
API keyDetermines whether the face in the submitted image belongs to a real, present person or a spoof — a photo of a photo, a mask or a screen.
POST
https://api.sprintcheck.megasprintlimited.com.ng/api/v1/face-livenessAuthorization
Send your secret API key in the Authorization header. Keys are issued per business — find them under Developers in your dashboard.
Authorization: <api_key>Parameters
Body parameters
imagestringrequiredThe facial image, Base64-encoded (JPEG or PNG).
Example: base64_encoded_image
PAYLOAD='{
"image": "base64_encoded_image"
}'
SIGNATURE=$(printf '%s' "$PAYLOAD" | tr -d '[:space:]' \
| openssl dgst -sha512 -hmac "$SPRINTCHECK_ENCRYPTION_KEY" \
| awk '{print $NF}')
curl -X POST "https://api.sprintcheck.megasprintlimited.com.ng/api/v1/face-liveness" \
-H "Authorization: $SPRINTCHECK_API_KEY" \
-H "signature: $SIGNATURE" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d "$PAYLOAD"{
"success": 1,
"message": "Face Liveness Detected Successfully",
"data": {
"face_locations": [
{
"age": 31,
"dominant_race": "black",
"dominant_gender": "Man",
"dominant_emotion": "happy",
"face_confidence": 0.99
}
],
"faces_detected": 1
}
}Representative example — field values are illustrative.
Test this endpoint
Simulated run — returns the example payload without calling the live API.