Facial verification
Face Detection
API keyAnalyses a single facial image and returns detected facial attributes — estimated age, gender, race and emotion probabilities — along with the region of each detected face.
POST
https://api.sprintcheck.megasprintlimited.com.ng/api/v1/faceAuthorization
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" \
-H "Authorization: $SPRINTCHECK_API_KEY" \
-H "signature: $SIGNATURE" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d "$PAYLOAD"{
"success": 1,
"message": "Face Detected Successfully",
"data": {
"face_locations": [
{
"age": 31,
"race": {
"asian": 25.71,
"black": 26.19,
"white": 23.01,
"indian": 4.88,
"middle eastern": 9.98,
"latino hispanic": 10.2
},
"gender": {
"Man": 70.27,
"Woman": 29.72
},
"region": {
"h": 1028,
"w": 719,
"x": 0,
"y": 0,
"left_eye": null,
"right_eye": null
},
"emotion": {
"sad": 0.85,
"fear": 0,
"angry": 0,
"happy": 99.14,
"disgust": 0,
"neutral": 0,
"surprise": 0
},
"dominant_race": "black",
"dominant_gender": "Man",
"face_confidence": 0.99,
"dominant_emotion": "happy"
}
],
"faces_detected": 1
}
}Representative example — field values are illustrative.
Test this endpoint
Simulated run — returns the example payload without calling the live API.