Face Verification

POST

/face-search

The Face Match API enables you to compare two facial images to determine if they belong to the same person. It is ideal for identity verification, access control, and user authentication.
Note: If multiple faces appear in an image, the API uses the face with the largest area to calculate the similarity score.

Request

Header Params

Body Params multipart/form-data

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://backend.verifix.itsecnow.com/v1/api/face-search' \
--header 'x-api-key;' \
--form 'user_image=@""' \
--form 'ref_image=@""'

Response Example

{
    "request_id": "df8fcae2-36c2-4416-af05-16f206a90bb7",
    "face_match": {
        "status": "Approved",
        "score": 97.96,
        "user_image": {
            "entities": [
                {
                    "age": 32.43,
                    "bbox": [
                        329,
                        465,
                        536,
                        715
                    ],
                    "confidence": 0.751057,
                    "gender": "male"
                }
            ],
            "best_angle": 0
        },
        "ref_image": {
            "entities": [
                {
                    "age": 32.43,
                    "bbox": [
                        329,
                        465,
                        536,
                        715
                    ],
                    "confidence": 0.751057,
                    "gender": "male"
                }
            ],
            "best_angle": 0
        },
        "warnings": []
    },
    "created_at": "2025-07-21T11:31:21.366013+00:00"
}

Modified at 2025-07-21 12:41:15

ID Verification

AML