Overview
The Liveness Detection API confirms that the person presenting an identity document is physically present and not using a photo, video, or spoofed image. By combining a real-time selfie challenge with biometric analysis, it adds a powerful anti-fraud layer to your verification flow.
Key Features
- Detects spoofing attempts including printed photos and screen replays
- Hosted liveness UI — no camera integration required on your end
- QR code support to hand off from desktop to mobile camera
- Captured selfie image available for audit or further matching
- Works as a standalone check or as part of the full Identity Verification flow
How It Works
Initiate
Call the API to create a liveness session. We return a unique session URL.
Capture
The user opens the URL on their device and completes a short guided selfie challenge.
Result
We analyse the selfie and return a pass/fail result, along with the captured image for your records.
Common Use Cases
Account opening
Ensure the person signing up is genuinely present, not impersonating someone else
Step-up authentication
Add a liveness check when a user performs a high-risk action
Selfie-to-document matching
Pair with document verification to confirm the holder matches the ID
One click services API
API Overview
Example Parameters
| Parameter | Description |
|---|---|
reference | Your internal reference ID for this check |
redirect_url | Where to send the user after the check completes |
Example Request
POST /liveness
{
"reference": "cust_00123",
"redirect_url": "https://yourapp.com/verified",
}Example Response
{
"status": "success",
"session_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"liveness_url": "https://verify.oneclickservices.com.au/b2c3d4e5-..."
}JWT REDIRECT
| Parameter | Value |
|---|---|
| realface |
| 0.87516615 |