Face Match (Two Images)

---

You can use the Face Match service by providing two face images to be compared. The result will be "True" if similar or "False" if not.

Face Match (Two Images)

POST https://valifystage.com/api/v1/face/match/

Headers

Name	Type	Description
Content-Type	string	application/json
Authentication	string	Bearer <access-token>

Request

Name	Type	Description
data*	object	Request details { first_img: <base64 str>, second_img: <base64 str>, bundle_key: <str>, lang: <str> }

Status Codes

✅200 Successful

{
    'result': {
        'is_similar': '<bool>', 
         'confidence': '<float>'
     }, 
     'transaction_id': '<str>', 
     'trials_remaining': '<int>'
 }

400 Missing input data

{
    "message": "Bad Request – invalid request received (e.g. missing Bundle key, required parameters or invalid json) | Make sure all the required parameters are included"
}

401 Invalid bundle key

{
    "message": "Unauthorized – your Bundle key is invalid"
}

403 Access token error

{
    "message": "Forbidden – specified access_token could not be found"
}

404 Check the endpoint

{
    "message": "Not Found"
}

415 The format should be base64

{
    "message": "Unsupported Media Type"
}

422 Check Valify error codes

{
    "message": "<error-description>",
    "error_code": <valify-error-code>
}

500 Contact us

{
    "message": "Internal Server Error"
}

---

Integration

🚀Postman

1. Download the JSON file.

2MB

Documentation - Face Match (2 images) (v1).postman_collection

Face Match (2 images)

1. Open Postman and click on Import.

1. Drop the JSON file.

1. Click on "Face Match" then click on "Authorization" and replace the <access token> field with your access token and then click on "Body".

1. Click on "Face Match" then "Body" and fill in the required fields then click on "Send".

Please note that the front and back images should be converted to base 64 format. This can be done via an online tool; https://base64.guru/converter/encode/image/jpg

🐍Python

import requests
import base64

def base64_encode(file_name):
    with open(file_name, "rb") as image_file:
        encoded_string = base64.b64encode(image_file.read()).decode()
        return encoded_string
    return ""

first_img = base64_encode('<image path>')
second_img = base64_encode('<image path>')
token = '<token>'
data = {
        'first_img': first_img,
        'second_img': second_img,
        'bundle_key': '<bundle key>', # Place your bundle key here
        'lang': '<lang>' # optional
}

r = requests.post("https://valifystage.com/api/v1/face/match",
        json=data,
        headers={'Authorization': 'Bearer %s' % token}
    )
                      
print(r.json())