1:1 Face Match
Compare two face images and get a match score using AI-powered facial recognition.
1:1 Face Match
A face comparison system examines an image of a face and predicts whether the face matches other faces in a database. Face comparison systems compare and predict potential matches of faces based on expression, facial hair, and age.
How It Works
Submit two Base64-encoded face images. The API compares them and returns a match score and match percentage indicating how similar the two faces are.
Request Parameters
| Parameter | Type | Location | Required | Description |
|---|---|---|---|---|
apikey | string | Header | Yes | API key provided by Syntizen. Pass 0 to skip encryption. |
authkey | string | Header | Yes | Authentication token obtained from the /userauthentication endpoint. |
rrn | string | Body | Yes | Request Reference Number — any unique identifier for the transaction. |
orientation_check | string | Body | Yes | Set to "true" to enable orientation correction before matching. |
image1 | string | Body | Yes | Base64-encoded reference face image. Supported formats: JPG, PNG, TIFF, PDF. |
image2 | string | Body | Yes | Base64-encoded face image to compare against. Supported formats: JPG, PNG, TIFF, PDF. |
Image Guidelines
- Supported formats: JPG, PNG, TIFF, PDF.
- Each image must contain exactly one clearly visible, forward-facing face.
- Ensure good lighting with no heavy occlusions (glasses, masks, hats).
- Higher resolution images improve matching accuracy.
Response
On a successful comparison, the response includes:
matchscore— raw similarity score (e.g.,"0.99").matchpercentage— percentage similarity (e.g.,"99").respdesc— result description (e.g.,"facial verification success").
Authorization
AuthKeyAuth Authentication token obtained from /userauthentication endpoint
In: header
Header Parameters
API key provided by Syntizen
Authentication token obtained from /userauthentication endpoint
Request Body
application/json
Request Reference Number
Whether to check orientation
Base64 image 1
Base64 image 2
Response Body
application/json
application/json
application/json
curl -X POST "https://api.syntizen.com/FaceMatch" \ -H "apikey: 0" \ -H "authkey: string" \ -H "Content-Type: application/json" \ -d '{ "rrn": "1", "orientation_check": "true", "image1": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAgGBgcmQlgMHPOPx//XXf6Pr8N35amQfMAQpOSf8AGvK2jjMMmUU4PHHStHTvl2leCFyMetTsabnv+6L/AJ5Q/wDfP/16K8++1XH/AD8S/wDfZorQnlR//9k=", "image2": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAgGBgcGBQgVmQlgMHPOPx//XXf6Pr8N35amQfMAQpOSf8AGvK2jjMMmUU4PHHStHTvl2leCFyMetTsabnv+6L/AJ5Q/wDfP/16K8++1XH/AD8S/wDfZorQnlR//9k=" }'{
"respcode": "200",
"respdesc": "facial verification success",
"rrn": "1",
"matchscore": "0.99",
"matchpercentage": "99"
}{
"respcode": "400",
"respdesc": "Bad Request - Missing or invalid request parameters"
}{
"respcode": "401",
"respdesc": "Unauthorized - Invalid or expired auth key"
}Face Passive Liveness V2 POST
Detect the presence of a real, live user in an image using passive liveness biometrics. Compares facial features including expression, facial hair, and age to confirm authenticity.
Face Verify POST
Confirm an individual's identity by comparing a live face image against enrolled faces in a group. Returns a match score for each enrolled identity.