Skip to main content

🛡️ Face Passive Liveness

The SDK wraps the Face Passive Liveness API in a single typed call — 0.3 IC per request. Submit one face image and the iBeta Level 1 certified engine tells you whether it is a real, live face or a spoofing attempt (printed photo, mask, screen replay). Use it when you already have a selfie and do not need interactive challenges — for stronger, challenge-based proof of presence use Face Active Liveness instead.

Flutter​

import 'package:iapp_ekyc_sdk/iapp_ekyc_sdk.dart';

final client = IappEkycClient(apiKey: 'YOUR_API_KEY');

final result = await client.checkPassiveLiveness(file: selfieBytes);

if (result.predict == 'REAL') {
  // Genuine live face
}

Web​

import { IappEkyc } from '@iapp-technology/ekyc-sdk';

const ekyc = new IappEkyc({ apiKey: 'YOUR_API_KEY' });

const result = await ekyc.passiveLiveness({ file: selfieBlob });

if (result.predict === 'REAL') {
  // Genuine live face
}

The response mirrors the API: predict (REAL / SPOOF), score, darkness, and the raw score breakdown — see the field reference.

Notes​

  • Detects printed photos, realistic masks, computer-screen captures, and video replays — iBeta Level 1 certified.
  • Images are held in memory only and sent exclusively to the configured baseUrl — the SDK never writes them to disk.
  • Billable call: the SDK never auto-retries after the request body has been sent.

Learn more​