Face Passive Liveness

The SDK wraps the iBeta Level 1 certified Face Passive Liveness API in one typed call: send one face image and learn whether it is a live face or a spoof (printed photo, mask, screen or video replay), at 0.3 IC per request. For challenge-based proof of presence, use Face Active Liveness.

Call

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
}

iOS / Android / React Native

The native wrappers capture a sharp frontal selfie with the faceCapture flow; send the returned JPEG to this API from your app or backend.

Install: Getting started for Flutter and Web, iOS, Android & React Native for the native wrappers and camera permission.

Result

The response mirrors the API: predict (REAL or SPOOF), score, darkness and the raw score breakdown. Field list: Face Passive Liveness API.

Data handling and retries

• Images are held in memory only and sent only to the configured baseUrl; the SDK never writes them to disk.
• This is a billable call: the SDK never retries it automatically once the request body has been sent.

The SDK is open source: github.com/iapp-technology/iapp-ekyc-sdk.