FaceFace Match - V2

Face Match V2 — Higher Accuracy Comparison

Next-gen face matching with improved accuracy and anti-spoofing. Better handling of lighting, angles, and image quality variations.

curl -X POST "https://production.deepvue.tech/v2/facematch" \
  -H "Authorization: Bearer YOUR_API_TOKEN (JWT)" \
  -H "x-api-key: YOUR_API_KEY" \
  --form file_a=example_string \
  --form file_b=example_string
{
  "code": 200,
  "sub_code": "SUCCESS",
  "message": "Face match completed.",
  "transaction_id": "24d4cc25-d576-4bfd-ac6a-43c5f770248d",
  "data": {
    "match": true,
    "confidence": 98
  }
}
POST
/v2/facematch
POST
Bearer Token (JWT)
Bearer Tokenstring
Required

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

ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
API Key (header: x-api-key)
x-api-keystring
Required

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

The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Content-Typestring
Required

The media type of the request body

Options: multipart/form-data
file_astring
Required
Format: binary
file_bstring
Required
Format: binary
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token (JWT). ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .

header
x-api-keystring
Required

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

Responses

codeinteger
sub_codestring
messagestring
transaction_idstring
dataobject

Overview

The Face Match V2 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 a boolean indicator of whether the faces match and a confidence score representing the accuracy of the match.

What's new in V2

  • PDF support: You can now submit PDF files as input documents in addition to image formats.
  • Improved response codes: More granular and actionable sub-codes are returned to help interpret and handle verification outcomes more effectively.