Likeness (Face Similarity) Check API

POST
/likeness_check
LIVE

Compares two face images and returns a similarity score plus a threshold-based pass or fail. Use it to validate whether an ID document portrait (typically from a driver licence) and a live selfie represent the same individual. The configurable similarity threshold lets you tighten or loosen the pass bar to suit your risk appetite.

calendar_today Request a Demo Contact Sales

Example Request

POST
request.json
key Auth: BearerAuth 
{
  "photo": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...",
  "probe_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...",
  "similarity_threshold": 80
}

Request Schema

photo
Required
string · (base64 / data URI)

Reference image. Typically the ID document portrait. JPEG or PNG. Max 5 MB.

probe_image
Required
string · (base64 / data URI)

Probe image. Typically a live selfie. JPEG or PNG. Max 5 MB.

similarity_threshold
Optional
number · (0 to 100)

Override the default threshold. If omitted, the system default is applied.

Available Response Data

4 Data Points
01
monitor_heart

result.similarity

biometric engine similarity score higher means more similar

02
monitor_heart

result.threshold

threshold applied

03
monitor_heart

result.biometric_passed

boolean, true when similarity is at or above the threshold

04
fingerprint

API reference UUID

lock Full API documentation provided after vetting from our compliance team.
By The Numbers

API Data Scale & Coverage tag

Unmatched data depth to power your compliance and verification workflows.

50M+
Phone & Email Records
40M+
Adverse Court Records
2BN+
Australian Universe Records
18M+
Real Estate Records
7M+
Deceased Records
980M+
Social Media & Employment Records
Practical Applications

Technical Use Cases tag

verified

Selfie vs document matching

A standalone face match for use cases that don't need full ID Pass orchestration. For example, confirming a customer matches the photo on a previously uploaded document at sensitive workflow steps.

verified

Step-up biometric authentication

Re-verify a customer at high-risk transaction points by matching a live selfie against their on-file enrolment photo.

verified

Audit-quality identity match

Provide auditable biometric match evidence for compliance teams investigating identity disputes or fraud claims.

Trust & Assurance

Compliance & Security tag

Enterprise-grade infrastructure audited against the standards your regulators require.

verified_user
ISO 27001 Certified
enhanced_encryption
AES-256 Encryption
public
Australian Data Sovereignty
Integration & Support

Common Questions tag

Everything you need to know about implementation details and compliance infrastructure.

rocket_launch Implementation

What happens if no face is detected?

add

The API returns a 400 with the message no_face_found. Make sure both images contain a clear, frontal face before submitting.

rocket_launch Implementation

What file size and format are allowed?

add

What file size and format are allowed? | answer: JPEG and PNG only. Maximum 5 MB per image. Supply as base64 data URIs (data:image/jpeg;base64,...) or raw base64.

rocket_launch Implementation

How should I choose a threshold?

add

Omit it and the system default applies. For higher-risk workflows, raise the threshold to reduce false acceptance. For lower-friction flows, lower it. The right value depends on your tolerance for false positives vs false negatives. Start with the system default and tune based on observed match distributions.

Try it Live

API Testing Sandbox tag

Test the Likeness (Face Similarity) Check API directly in your browser with live mock data and see instant results.

rocket_launch Request Sandbox Access

Access to live sandbox environments requires manual approval from our compliance team.

(03) 9948 4089
Request a Demo
BACK TO TOP