Simplici Docs

Face Match

Compare a selfie against an identity-document portrait and get a similarity score.

Face Match API Guide

The Face Match API analyzes two facial images — typically a selfie and an ID document photo — to determine whether they belong to the same person.

The API returns a match score between 0 and 1, where values closer to 1 indicate a stronger facial similarity.

Endpoint

https://api.satschel.com/v2/kyc/face-match

Sandbox Endpoint

https://api.beta.satschel.com/v2/kyc/face-match

Method

POST

Request Headers

  • Content-Type: application/json
  • Authorization: Bearer YOUR_ACCESS_TOKEN.

Request Body

ParameterTypeDescription
sourceImageBase64StringstringBase64-encoded image of the source face (e.g. selfie)
targetImageBase64StringstringBase64-encoded image of the target face (e.g. ID document)

Example Request Body

{
    "sourceImageBase64String": "source image base64 string",
    "targetImageBase64String": "target image base64 string"
}

Direct Response

{
    "message": "ok",
    "data": {
        "message": "Face matched",
        "score": "0.99",
        "status": true
    }
}

On this page