Release date: May 25, 2026
Facephi IAD Service 2.0.0 is a major version that introduces a new public REST contract for the liveness and extraction flows. This version is not backward compatible with the 1.x.x series.
POST /api/v1/iad/check-capture
POST /api/v1/iad/liveness/evaluate
POST /api/v1/iad/extract-image
POST /api/v1/iad/extract
Multipart requests now require the field capture.
Requests that only include the legacy field file without capture are rejected.
Public success payloads now expose Facephi-style fields such as diagnostic, reason, probability, score, faceProbability, sdkDuration and queueDuration.
Legacy Engine-shaped fields, such as capture_liveness, capture_type, rejection and mime_type, are no longer returned in public success responses.
Liveness responses are mapped to a stable public contract focused on Facephi integration fields.
The public values of reason liveness are explicitly documented as None, Unknown, UntrustedEnvironment, SuspiciousActivity, UntrustedDevice, SdkIntegrityViolation, UntrustedCorruptedPayload, UntrustedContent and UntrustedContentLowConfidence.
Capture validation errors are normalized to Facephi/SelphID-style values.
The service can apply a freshness window to incoming capture payloads.
Startup environment variables FACEPHI_IAD_REPLAY_ATTACK_CHECKER_ENABLED and FACEPHI_IAD_REPLAY_ATTACK_TOLERANCE_TIME enable and configure the functionality.
The default freshness window is 300 seconds.
When the freshness window is exceeded, capture processing endpoints return HTTP 400 with message equal to Replay attack detected.
Service startup failures are propagated to main instead of terminating from internal startup components.
Signal handling no longer performs signal-unsafe operations such as logging, shutdown logic, or std::exit, directly from handlers.
Unit tests were added for public success payload mapping and the prevention of private field leaks.
Unit tests were added to verify the behavior of the required multipart field capture.
Update the endpoint paths in client integrations.
Rename the multipart form field from file to capture.
Update response parsing for successful liveness requests so that they use the new public fields.
Validate the integration behavior with GET /api/v1/iad/version and end-to-end tests in your environment.
Operating system
Linux x86_64 (Ubuntu 24.04 recommended)
License
Valid Facephi License file
Docker
For container deployment
For Technical Support, contact your Facephi representative.
Last updated
docker pull facephicorp.jfrog.io/docker-core-pro-fphi/facephi-iad-service:2.0.0
docker run -d \
-p 6982:6982 \
-v /path/to/license:/app/license \
-v /path/to/config:/app/config \
--name iad-service \
facephicorp.jfrog.io/docker-core-pro-fphi/facephi-iad-service:2.0.0