Check a selfie against an ID or photo
face_verifyCompare a selfie with an ID document or face photo, detect spoofing, and check document authenticity to support identity verification decisions.
Instructions
Check that a selfie shows the same person as an ID document or face photo, and that the selfie is a genuine capture (not a printout, screen, mask or synthetic face), via Face Terminal (POST /v1/face/verify). When the reference is a passport, ID card, residence permit or driving licence, the document is checked too. Takes local file paths (JPEG, PNG or WebP, up to 12 MB each). Returns status (verified, review or failed), reasons, the face match, the spoof check and the document check. Uses one check from the key's quota. You need a lawful basis, usually the person's explicit consent, to send their face. A result supports a human decision.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"reference": "<reference>",
"selfie": "<selfie>"
},
"name": "face_verify"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| back | No | Path to the back of the ID card or driving licence in reference (optional) | |
| full | No | Return the whole API response instead of a summary | |
| selfie | Yes | Path to a selfie of the person, taken now | |
| reference | Yes | Path to the ID document page or a clear face photo to match against |