curl --request POST \
--url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/biometrics-face-compare-passthrough \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"image1": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
"image2": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD..."
}
'{
"success": true,
"message": "Biometrics Face Compare processed successfully",
"data": {
"similarityScore": 94.21
},
"verificationStatus": "VERIFIED",
"verificationStatusCode": 3,
"transactionId": "7b3e9c14-2a68-4d05-91f7-6c8d0b2e4a31",
"verificationType": "biometrics_face_compare",
"metadata": {
"customerReference": "CUST-10294"
},
"createdAt": "2026-09-14 04:12:37+0000"
}Biometrics Face Compare
Compare two face images and return a similarity score through the passthrough endpoint. This endpoint is commonly used to compare the potrait image from a personal identification document against a face image
curl --request POST \
--url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/biometrics-face-compare-passthrough \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"image1": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
"image2": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD..."
}
'{
"success": true,
"message": "Biometrics Face Compare processed successfully",
"data": {
"similarityScore": 94.21
},
"verificationStatus": "VERIFIED",
"verificationStatusCode": 3,
"transactionId": "7b3e9c14-2a68-4d05-91f7-6c8d0b2e4a31",
"verificationType": "biometrics_face_compare",
"metadata": {
"customerReference": "CUST-10294"
},
"createdAt": "2026-09-14 04:12:37+0000"
}Related endpoint
Face compare answers whether two faces belong to the same person. Biometrics Verification answers whether a single selfie shows a live person. A full remote-identity check usually calls both.Authorizations
Use your API token as a Bearer token in the Authorization header.
Headers
"Bearer {your_api_token}"
Body
Base64 data URI (for example data:image/jpeg;base64,...), or a multipart file upload when posting multipart/form-data. URLs are not accepted.
The face to compare against, in the same accepted formats as image1. URLs are not accepted.
Percentage (0–100). Similarity scores below this value are REJECTED
0 <= x <= 100Percentage (0–100). Similarity scores at or above this value are VERIFIED. When the similarity score is between minSimilarityScore and verifiedSimilarityScore, the outcome is REVIEW_NEEDED.
0 <= x <= 100Free-form correlation data, echoed back on the response.
Response
Comparison completed. Verified, review-needed, and rejected outcomes all use HTTP 200.
true
Show child attributes
Show child attributes
VERIFIED, REVIEW_NEEDED, REJECTED 3 = Verified, 2 = Review Needed, 1 = Rejected.
3, 2, 1 "biometrics_face_compare"
"2026-09-14 04:12:37+0000"