Face compare (two faces)

POST

/v1/ocr/face/compare

POST

/v1/ocr/face/compare

curl -X POST https://api.vlenseg.com/v1/ocr/face/compare \
     -H "ApiKey: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "face_image1": "string",
  "face_image2": "string"
}'

200Successful

{
  "services": {
    "validations": {
      "validation_errors": [
        {
          "field": "string",
          "value": "string",
          "errors": [
            {
              "code": 1,
              "message": "string"
            }
          ]
        }
      ]
    },
    "spoofing": {
      "fake": true
    },
    "classification": {
      "doc_type": "string"
    },
    "liveness": true,
    "AML": {},
    "SRC": {}
  },
  "data": {
    "isMatched": "string",
    "dissimilarity": "string",
    "threshold": "string",
    "score": "string",
    "transaction_id": "string",
    "request_id": "string",
    "client_transaction_id": "string"
  },
  "error_code": 1,
  "error_message": "string"
}

Compares any two face images directly, without requiring an ID transaction.

Authentication

ApiKeystring

Static API key issued to your tenant. Required on every request.

AuthorizationBearer

End-user JWT from registration or login. Required for verification, signing, and user-scoped operations.

Request

This endpoint expects an object.

face_image1stringRequired

Base64-encoded first face image.

face_image2stringRequired

Base64-encoded second face image.

livenessstringOptional

Liveness mode, e.g. "2".

Response

servicesobjectOptional

Per-service check results attached to every OCR response.

dataobjectOptional

error_codeinteger or nullOptional

error_messagestring or nullOptional