Liveness

The Liveness capability provides automated checks that ensure the end user is physically present during the verification and is not attempting a spoofing attack.

Dependencies

Dependencies include Usability and Selfie that is acquired for the workflow must be PASSED by the Usability capability.

Supported Credential include

• Facemap
• Selfie

A Facemap is optional, but significantly improves the reliability of the Liveness checks. The Facemap can only be acquired by using the Web Client or one of the Jumio SDKs.

Response

Response data is available for transactions that include the Liveness capability. For information on transaction data see this.

JUMIO_STANDARD

  "liveness": [
    {
      "id": "a070b186-d678-4de8-9a5f-5a15a35e99a4",
      "credentials": [
        {
          "id": "fe84b047-c9fb-490b-8358-009ee4e695a5",
          "category": "SELFIE"
        },
        {
          "id": "398cf6bf-524d-4fd5-b2a8-586e3df89502",
          "category": "FACEMAP"
        }
      ],
      "decision": {
        "type": "PASSED",
        "details": {
          "label": "OK"
        }
      },
      "data": {
        "type": "JUMIO_STANDARD",
        "predictedAge": 49,
        "ageConfidenceRange": "14-67"
      }
    }
  ],

JUMIO_PREMIUM

"liveness": [
  {
    "id": "a070b186-d678-4de8-9a5f-5a15a35e99a4",
    "credentials": [
                {
        "id": "398cf6bf-524d-4fd5-b2a8-586e3df89502",
        "category": "FACEMAP"
      },
      {
        "id": "fe84b047-c9fb-490b-8358-009ee4e695a5",
        "category": "SELFIE"
      }
    ],
    "decision": {
      "type": "PASSED",
      "details": {
        "label": "OK"
      }
    },
    "data": {
      "type": "JUMIO_PREMIUM",
      "predictedAge": 24,
      "ageConfidenceRange": "13-42"
    }
  }
],

Decision Details Labels

Decision Type	Label	Description
NOT_EXECUTED	PRECONDITION_NOT_FULFILLED	Required data from another capability is not available.
NOT_EXECUTED	TECHNICAL_ERROR	An error prevented execution.
PASSED	OK	Analysis determined that the end user was physically present during the verification process.
REJECTED	LIVENESS_UNDETERMINED	Liveness cannot be determined.
REJECTED	ID_USED_AS_SELFIE	An ID photo was used for the selfie.
REJECTED	MULTIPLE_PEOPLE	More than one person appears in the selfie.
REJECTED	DIGITAL_COPY	The selfie was captured from a screen.
REJECTED	PHOTOCOPY	The selfie was captured from a paper printout.
REJECTED	MANIPULATED	The selfie was manipulated prior to uploading (for example, a background swap).
REJECTED	NO_FACE_PRESENT	A face does not appear in the selfie.
REJECTED	FACE_NOT_FULLY_VISIBLE	The face is only partially visible in the selfie.
REJECTED	BLACK_WHITE	The selfie image is black and white.
WARNING	AGE_DIFFERENCE	There is a large difference between the estimated selfie age and the date of birth on the ID.
WARNING	BAD_QUALITY	The selfie is of bad quality.

tip

For an overview of how Jumio handles PASSED, WARNING, and REJECTED across all capabilities, see How Jumio Handles Results.

Data

Key	Type	Description
type	string	The service that is used. Possible values: JUMIO_STANDARD JUMIO_PREMIUM (requires additional configuration for your tenant) The technology used is based on the product purchased.
predictedAge	integer	Estimated age of the end user based on the selfie.
ageConfidenceRange	string	Age range into which the end user would fall.