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
import requests
import json
url = "https://production.deepvue.tech/v2/facematch"
headers = {
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
}
data = {
"file_a": "example_string",
"file_b": "example_string"
}
response = requests.post(url, headers=headers, data=data)
print(response.json())
const formData = new FormData();
formData.append("file_a", "example_string");
formData.append("file_b", "example_string");
const response = await fetch("https://production.deepvue.tech/v2/facematch", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
},
body: formData
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"mime/multipart"
)
func main() {
body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
writer.WriteField("file_a", "example_string")
writer.WriteField("file_b", "example_string")
writer.Close()
req, err := http.NewRequest("POST", "https://production.deepvue.tech/v2/facematch", body)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN (JWT)")
req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Content-Type", writer.FormDataContentType())
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://production.deepvue.tech/v2/facematch')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_TOKEN (JWT)'
request['x-api-key'] = 'YOUR_API_KEY'
request.set_form([
["file_a", "example_string"],
["file_b", "example_string"]
], 'multipart/form-data')
response = http.request(request)
puts response.body
{
"code": 200,
"sub_code": "SUCCESS",
"message": "Face match completed.",
"transaction_id": "24d4cc25-d576-4bfd-ac6a-43c5f770248d",
"data": {
"match": true,
"confidence": 98
}
}
{
"code": 200,
"sub_code": "SUCCESS",
"message": "Face match completed.",
"transaction_id": "ca6d5795-b806-4a1d-b158-e889d2b53ee3",
"data": {
"match": false,
"confidence": 44
}
}
{
"detail": "Inactive client_id"
}
{
"detail": "Not authenticated"
}
{
"detail": "Not a valid token"
}
{
"code": 422,
"timestamp": 1745915278802,
"transaction_id": "f76d1ec7abb446f690e1a4bfd8ff210f",
"sub_code": "UNSUPPORTED_FILE_FORMAT",
"message": "Please upload a valid PDF or image file."
}
{
"code": 422,
"timestamp": 1745915335416,
"transaction_id": "4a3f51617dce4f87820910d715d4fbfb",
"sub_code": "NO_FACE_DETECTED",
"message": "No faces detected in the provided files."
}
{
"code": 422,
"timestamp": 1745916318378,
"transaction_id": "6701c248200d4f06ab8ee1bebc38de59",
"sub_code": "INVALID_PDF",
"message": "Could not process uploaded PDF."
}
{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}
{
"detail": "Internal Server Error"
}
/v2/facematch
ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
The media type of the request body
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token (JWT). ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
API Key for authentication. The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Responses
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.
Last updated 4 weeks ago
Built with Documentation.AI