Skip to main content
POST
/
api
/
v3
/
verifications
/
biometrics-face-compare
Biometrics Face Compare
curl --request POST \
  --url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/biometrics-face-compare \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "image1": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
  "image2": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
  "trustFlowId": 0,
  "trustValidationId": "{your_trust_validation_id}"
}
'
{
  "success": true,
  "message": "Face compare verification processed successfully",
  "data": {
    "similarityScore": 99
  },
  "verificationStatus": "VERIFIED",
  "verificationStatusCode": 3,
  "trustFlowId": 0,
  "trustValidationId": "{your_trust_validation_id}",
  "verificationType": "biometrics_face_compare",
  "metadata": null
}

Authorizations

Authorization
string
header
required

Use Bearer {your_api_token} in the Authorization header.

Headers

Accept
string
default:application/json
Content-Type
string
default:application/json

Body

application/json
image1
string
required

First face image as a base64 data URI (for example, data:image/jpeg;base64,...).

image2
string
required

Second face image as a base64 data URI (for example, data:image/jpeg;base64,...).

trustFlowId
integer
required

Identifier used to categorize or group requests for tracking or reporting.

trustValidationId
string
required

A unique ID used to identify your verification request.

Response

200 - application/json

Face compare completed successfully

success
boolean
required
message
string
required
data
object
required
verificationStatus
string
required
verificationStatusCode
integer
required
trustFlowId
integer
required
trustValidationId
string
required
verificationType
string
required
metadata
unknown