Face Match - V2

The Realtime Face Match API enables quick and reliable face comparison between two documents.

It accepts two files—either two ID card images or PDFs, or one ID card and a selfie—and performs AI-powered facial recognition for real-time identity verification.

The API returns:

• Whether the faces match or not
• A confidence score indicating the accuracy of the match

What’s New in v2? 📄 PDF Support Added: You can now submit PDF files as input documents in addition to images.

🛠️ Improved Response sub_code: More granular and actionable sub-codes are returned to help better interpret and handle verification outcomes.

POST /v2/facematch

Compare faces in two files

cURL

curl --request POST \
  --url https://production.deepvue.tech/v2/facematch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form file_a='@example-file' \
  --form file_b='@example-file'

200

200 - Face Match - Match True

{
  "code": 200,
  "sub_code": "SUCCESS",
  "message": "Face match completed.",
  "transaction_id": "24d4cc25-d576-4bfd-ac6a-43c5f770248d",
  "data": {
    "match": true,
    "confidence": 98
  }
}

Authorizations

Authorization · string · header · required

ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .

x-api-key · string · header · required

The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.

Body

multipart/form-data

file_a · file · required

file_b · file · required

Response

200

application/json

Successful Response

code · integer · default: 200

sub_code · string · default: SUCCESS

message · string · default: Face match completed.

transaction_id · string

data · Data · object

Show child attributes